diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..826ceba
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,61 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+# Usually these files are written by a python script from a template
+# before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+.env/
diff --git a/README.rst b/README.rst
index 1ce3b67..160c47c 100644
--- a/README.rst
+++ b/README.rst
@@ -169,6 +169,12 @@ Variables and feature toggles
``"account/repo"`` string - used to display a `Codecov`_
build status button in the sidebar. If ``true``, uses your
``github_(user|repo)`` settings; defaults to ``false.``
+* ``rtd_button``: ``true``, ``false`` or ``github_repo`` string -- used to display a `ReadTheDocs`_
+ status button in the sidebar. If ``true``, uses your
+ ``github_repo`` settings; defaults to ``false.``
+* ``pypi_button``: ``true``, ``false`` or ``github_repo`` string -- used to display a `PyPi`_
+ status button in the sidebar. If ``true``, uses your
+ ``github_repo`` settings; defaults to ``false.``
* ``gratipay_user``: Set to your `Gratipay {{ project }}
+
+
+
+
+
+
+
+