1 files changed, 74 insertions, 0 deletions
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..f51d8b2
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,74 @@
+**************************
+Read the Docs Sphinx Theme
+**************************
+
+.. image:: https://img.shields.io/pypi/v/sphinx_rtd_theme.svg
+   :target: https://pypi.python.org/pypi/sphinx_rtd_theme
+   :alt: Pypi Version
+.. image:: https://circleci.com/gh/readthedocs/sphinx_rtd_theme.svg?style=svg
+   :alt: Build Status
+   :target: https://circleci.com/gh/readthedocs/sphinx_rtd_theme
+.. image:: https://img.shields.io/pypi/l/sphinx_rtd_theme.svg
+   :target: https://pypi.python.org/pypi/sphinx_rtd_theme/
+   :alt: License
+.. image:: https://readthedocs.org/projects/sphinx-rtd-theme/badge/?version=latest
+  :target: http://sphinx-rtd-theme.readthedocs.io/en/latest/?badge=latest
+  :alt: Documentation Status
+
+This Sphinx_ theme was designed to provide a great reader experience for
+documentation users on both desktop and mobile devices. This theme is used
+primarily on `Read the Docs`_ but can work with any Sphinx project. You can find
+a working demo of the theme in the `theme documentation`_
+
+.. _Sphinx: http://www.sphinx-doc.org
+.. _Read the Docs: http://www.readthedocs.org
+.. _theme documentation: https://sphinx-rtd-theme.readthedocs.io/en/stable/
+
+Installation
+============
+
+This theme is distributed on PyPI_ and can be installed with ``pip``:
+
+.. code:: console
+
+   $ pip install sphinx-rtd-theme
+
+To use the theme in your Sphinx project, you will need to edit
+your ``conf.py`` file's ``html_theme`` setting:
+
+.. code:: python
+
+    html_theme = "sphinx_rtd_theme"
+
+.. admonition:: See also:
+
+    `Supported browsers`_
+        Officially supported and tested browser/operating system combinations
+
+    `Supported dependencies`_
+        Supported versions of Python, Sphinx, and other dependencies.
+
+    `Example documentation`_
+        A full example of this theme output, with localized strings enabled.
+
+.. _PyPI: https://pypi.python.org/pypi/sphinx_rtd_theme
+.. _Supported browsers: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-browsers
+.. _Supported dependencies: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-dependencies
+.. _Example documentation:  https://sphinx-rtd-theme.readthedocs.io/en/stable/
+
+Configuration
+=============
+
+This theme is highly customizable on both the page level and on a global level.
+To see all the possible configuration options, read the documentation on
+`configuring the theme`_.
+
+.. _configuring the theme: https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html
+
+Contributing
+============
+
+If you would like to help modify or translate the theme, you'll find more
+information on contributing in our `contributing guide`_.
+
+.. _contributing guide: https://sphinx-rtd-theme.readthedocs.io/en/stable/contributing.html