From fc76a1896fc02c6b72dcbd0a061557a4779c7e6d Mon Sep 17 00:00:00 2001
From: Nicolas Joyard <joyard.nicolas@gmail.com>
Date: Thu, 30 Jun 2016 09:06:34 +0200
Subject: [PATCH] Document score formula and parameters

---
 docs/img/score_10years.png | Bin 0 -> 3879 bytes
 docs/img/score_1year.png   | Bin 0 -> 5627 bytes
 docs/img/score_exp1k.png   | Bin 0 -> 3170 bytes
 docs/img/score_exp6.png    | Bin 0 -> 4719 bytes
 docs/img/score_formula.png | Bin 0 -> 6130 bytes
 docs/index.rst             |   1 +
 docs/scores.rst            |  64 +++++++++++++++++++++++++++++++++++++
 7 files changed, 65 insertions(+)
 create mode 100644 docs/img/score_10years.png
 create mode 100644 docs/img/score_1year.png
 create mode 100644 docs/img/score_exp1k.png
 create mode 100644 docs/img/score_exp6.png
 create mode 100644 docs/img/score_formula.png
 create mode 100644 docs/scores.rst

diff --git a/docs/img/score_10years.png b/docs/img/score_10years.png
new file mode 100644
index 0000000000000000000000000000000000000000..bef922b8906ac6410650601351336f4909c11b43
GIT binary patch
literal 3879
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
N!1RoDOSSJr{0I8KS&9Gv

literal 0
HcmV?d00001

diff --git a/docs/img/score_1year.png b/docs/img/score_1year.png
new file mode 100644
index 0000000000000000000000000000000000000000..50d579aabb7e771c656500b97f7c1f6997ecbf1d
GIT binary patch
literal 5627
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
H+eiHmk?d`Z

literal 0
HcmV?d00001

diff --git a/docs/img/score_exp1k.png b/docs/img/score_exp1k.png
new file mode 100644
index 0000000000000000000000000000000000000000..40a43e73ad235b16cec2ef562ddaae9fae9ae896
GIT binary patch
literal 3170
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

literal 0
HcmV?d00001

diff --git a/docs/img/score_exp6.png b/docs/img/score_exp6.png
new file mode 100644
index 0000000000000000000000000000000000000000..9262e8c05ca5e6c9a0b0262ff6bdc24946c09831
GIT binary patch
literal 4719
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
X(4V>7_0Iu+4S}ErCi+!+E^+?{XQd5*

literal 0
HcmV?d00001

diff --git a/docs/img/score_formula.png b/docs/img/score_formula.png
new file mode 100644
index 0000000000000000000000000000000000000000..131e4d8a5ed7b59c4ea92408f150cb7cdbe8f930
GIT binary patch
literal 6130
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
Ef=fSx&j0`b

literal 0
HcmV?d00001

diff --git a/docs/index.rst b/docs/index.rst
index 05a6e669..76d8172a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -14,6 +14,7 @@ Contents:
    usage
    deployment
    administration
+   scores
    api
    development
    hacker
diff --git a/docs/scores.rst b/docs/scores.rst
new file mode 100644
index 00000000..529e74f7
--- /dev/null
+++ b/docs/scores.rst
@@ -0,0 +1,64 @@
+Memopol Scores
+~~~~~~~~~~~~~~
+
+Score computation
+=================
+
+In Memopol, each representative has a score that shows how their votes match
+the recommendations made by administrators on the instance.  The total score
+of a representative is the sum of their score on each dossier, which in turn is
+the sum of their score on each proposal with a recommendation on the dossier.
+
+Each recommendation made by administrators has a weight: a number that tells how
+important a specific proposal is.  When the representative vote on a proposal
+matches the recommendation, their score on the proposal is set to +weight.
+Otherwise, it is set to -weight.
+
+Score decay parameters
+======================
+
+Memopol allows to set decay parameters so that older votes have a lower
+importance in the total representative score.  By default, those parameters are
+set to values that disable the score decay, so that each vote contributes
+identically to the total score no matter how old it is.
+
+The formula used to compute score is the following:
+
+.. image:: img/score_formula.png
+
+Where:
+
+* ``baseScore`` is the base score for the vote computed as explained above;
+* ``voteAge`` is the age of the vote in days;
+* ``decayNum`` and ``decayDenom`` define the decay rate;
+* ``exponent`` define the steepness of the decay.
+
+The corresponding parameters can be set from the Memopol administration
+interface (Memopol Settings > Settings); settings keys are ``SCORE_DECAY_NUM``,
+``SCORE_DECAY_DENOM``, ``SCORE_EXPONENT``. Additionnaly, the ``SCORE_DECIMALS``
+parameter sets how many decimal places are visible when scores are displayed.
+
+The default values for those settings disable score decay by setting
+``SCORE_DECAY_NUM`` to 0, ``SCORE_DECAY_DENOM`` and ``SCORE_EXPONENT`` to 1.
+
+If you want to use score decay, start by setting ``SCORE_DECAY_NUM`` to 1, and
+``SCORE_DECAY_DENOM`` to the number of days you want votes to matter.  The graph
+below shows how a score of 1.0 will decay with a 1-year decay (the X axis is in
+days).
+
+.. image:: img/score_1year.png
+
+Increasing ``SCORE_DECAY_DENOM`` will make votes matter longer.  Here is the
+same example but with a 10-year decay.
+
+.. image:: img/score_10years.png
+
+Increasing ``SCORE_EXPONENT`` instead will make the decay cutoff steeper.  Here
+is an example with a 1-year decay and the exponent set to 6.
+
+.. image:: img/score_exp6.png
+
+Increasing it dramatically will create a brutal cutoff; here is the same example
+with the exponent set to 1000:
+
+.. image:: img/score_exp1k.png
-- 
GitLab