Rewrite the README

Gauvain Pocentek · Gauvain Pocentek · commit 3e8cf4e9ea59 · 2016-01-09T15:42:19.000+01:00
And link to the docs on RTD.
diff --git a/MANIFEST.in b/MANIFEST.in
@@ -1,3 +1,3 @@
-include README.md COPYING AUTHORS ChangeLog requirements.txt test-requirements.txt
+include COPYING AUTHORS ChangeLog requirements.txt test-requirements.txt
 include tox.ini .testr.conf
 recursive-include tools *
diff --git a/README.md b/README.md
diff --git a/README.rst b/README.rst
@@ -0,0 +1,37 @@
+Python GitLab
+=============
+
+``python-gitlab`` is a Python package providing access to the GitLab server API.
+
+It supports the v3 api of GitLab, and provides a CLI tool (``gitlab``).
+
+Installation
+============
+
+Requirements
+------------
+
+python-gitlab depends on:
+
+* `python-requests <http://docs.python-requests.org/en/latest/>`_
+* `six <https://pythonhosted.org/six/>`_
+
+Install with pip
+----------------
+
+.. code-block:: console
+
+   pip install python-gitlab
+
+Bug reports
+===========
+
+Please report bugs and feature requests at
+https://github.com/gpocentek/python-gitlab/issues.
+
+
+Documentation
+=============
+
+The documentation for CLI and API is available on `readthedocs
+<http://python-gitlab.readthedocs.org/en/stable/>`_.
