doc tweaks

README.rst

@@ -7,7 +7,7 @@
 
 :Documentation: `Documentation at Readthedocs <https://cobaya.readthedocs.org>`_
 
-:Licence: `LGPL <https://www.gnu.org/licenses/lgpl-3.0.en.html>`_ + mandatory bug reporting asap + mandatory `arXiv'ing <arxiv.org>`_ of publications using it (see `LICENCE.txt <https://github.com/CobayaSampler/cobaya/blob/master/LICENCE.txt>`_ for exceptions). The documentation is licensed under the `GFDL <https://www.gnu.org/licenses/fdl-1.3.en.html>`_.
+:Licence: `LGPL <https://www.gnu.org/licenses/lgpl-3.0.en.html>`_ + mandatory bug reporting asap + mandatory `arXiv'ing <https://arxiv.org>`_ of publications using it (see `LICENCE.txt <https://github.com/CobayaSampler/cobaya/blob/master/LICENCE.txt>`_ for exceptions). The documentation is licensed under the `GFDL <https://www.gnu.org/licenses/fdl-1.3.en.html>`_.
 
 :E-mail list: https://cosmocoffee.info/cobaya/ – **sign up for important bugs and release announcements!**
 

cobaya/prior.py

@@ -36,7 +36,8 @@
 for a chain will attempt to draw it from the ``ref`` if it has been defined (otherwise
 from the prior). A good reference pdf will avoid a long *burn-in* stage during the
 sampling. If you assign a single value to ``ref``, samplers will always start from
-that value.
+that value; however this makes convergence tests less reliable as each chain will
+start from the same point (so all chains could be stuck near the same point).
 
 
 The syntax for priors and ref's has the following fields:
@@ -60,8 +61,8 @@
    ``scale`` (NB: unexpected behaviour for an unbounded pdf).
 
 
-The order of the parameters is conserved in the table of samples, except the fact that
-derived parameters are always moved to the last places.
+The order of the parameters is conserved in the table of samples, except that
+derived parameters are always moved to the end.
 
 An example ``params`` block:
 

docs/index.rst

@@ -65,6 +65,5 @@ Table of contents
 Indices and tables
 ==================
 
-* :ref:`genindex`
 * :ref:`modindex`
 * :ref:`search`