[doc] readthedocs strangeness

AUTHORS.txt

@@ -1 +1 @@
-[GPy Authors](https://github.com/SheffieldML/GPy/graphs/contributors)
+GPy Authors: https://github.com/SheffieldML/GPy/graphs/contributors

README.rst

@@ -1,12 +1,16 @@
-# GPy
+===
+GPy
+===
 
 The Gaussian processes framework in Python.
+-------------------------------------------
 
-* GPy [homepage](http://sheffieldml.github.io/GPy/)
-* Tutorial [notebooks](http://nbviewer.ipython.org/github/SheffieldML/notebook/blob/master/GPy/index.ipynb)
-* User [mailing-list](https://lists.shef.ac.uk/sympa/subscribe/gpy-users)
-* Developer [documentation](http://gpy.readthedocs.org/en/devel/)
-* Travis-CI [unit-tests](https://travis-ci.org/SheffieldML/GPy)
-* [![licence](https://img.shields.io/badge/licence-BSD-blue.svg)](http://opensource.org/licenses/BSD-3-Clause) 
+- `GPy homepage <http://sheffieldml.github.io/GPy/>`_
+- `Tutorial notebooks <http://nbviewer.ipython.org/github/SheffieldML/notebook/blob/master/GPy/index.ipynb>`_
+- `User mailing-list <https://lists.shef.ac.uk/sympa/subscribe/gpy-users>`_
+- `Developer documentation <http://gpy.readthedocs.org/en/devel/>`_
+- `Travis-CI unit-tests <https://travis-ci.org/SheffieldML/GPy>`_
+- .. image:: https://img.shields.io/badge/licence-BSD-blue.svg 
+      :target: https://opensource.org/licenses/BSD-3-Clause
 
-For full description please refer to the [github page](http://sheffieldml.github.io/GPy/)
+For full description and installation instructions please refer to the github page.

doc/source/conf.py

@@ -21,7 +21,7 @@ import shlex
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #for p in os.walk('../../GPy'):
 #    sys.path.append(p[0])
-sys.path.insert(0, os.path.abspath('../../'))
+#sys.path.insert(0, os.path.abspath('../../'))
 sys.path.insert(0, os.path.abspath('../../GPy/'))
 
 on_rtd = os.environ.get('READTHEDOCS', None) == 'True'

setup.py

@@ -57,7 +57,7 @@ def read_to_rst(fname):
     except ImportError:
         return read(fname)
 
-#desc = read_to_rst('README.md')
+desc = read('README.rst')
 
 version_dummy = {}
 exec(read('GPy/__version__.py'), version_dummy)
@@ -143,7 +143,7 @@ setup(name = 'GPy',
       include_package_data = True,
       py_modules = ['GPy.__init__'],
       test_suite = 'GPy.testing',
-      #long_description=desc,
+      long_description=desc,
       install_requires=['numpy>=1.7', 'scipy>=0.16', 'six', 'paramz'],
       extras_require = {'docs':['sphinx'],
                         'optional':['mpi4py',