Little section on popcon

diff --git a/sphinx/index.rst b/sphinx/index.rst
index 9da15da0456e1aa3719566a99acf5ce122497201..b701e712a1a98c86ecdfbc3eb391889febbe3ef9 100644 (file)
--- a/sphinx/index.rst
+++ b/sphinx/index.rst
@@ -95,6 +95,35 @@ the terminal you can use :command:`apt-get`::
   please have a look at the corresponding package pages.
 
 
+Popularity Contest
+------------------
+
+We would strongly encourage you to participate in the `popularity
+contest <http://popcon.debian.org>`_ (popcon), which anonymously
+collects the list of packages you installed/use on your system.
+Collecting such statistics is of particular importance for research
+software projects as a prove of an existing user-base.  If upon
+installation of the system you rejected the invitation to participate
+you can always change your decision by running::
+
+ sudo dpkg-reconfigure popularity-contest
+
+.. note::
+
+   If you are deploying multiple systems through cloning, to not have
+   all systems considered as one, it would be necessary to re-generate
+   the random MY_HOSTID.  Following commands ran as root should do it
+   (as root) without any interactive dialog::
+
+    sed -i -e 's,PARTICIPATE *= *.no.,PARTICIPATE="yes",g' -e '/^ *MY_HOSTID/d' /etc/popularity-contest.conf
+    DEBIAN_FRONTEND=noninteractive dpkg-reconfigure popularity-contest
+
+In addition to popcon pages for your "core" distribution (e.g. `Debian
+<http://popcon.debian.org/>`__ or `Ubuntu
+<http://popcon.ubuntu.com/>`__) you can see/get statistics for
+submissions to `NeuroDebian <http://neuro.debian.net/popcon/>`__ and
+know that you are already contributing back to the community.
+
 .. _chap_installation:
 
 Ways to use NeuroDebian