docs theme

README.rst

@@ -11,9 +11,10 @@ project.
 Project Info
 ------------
 
-- Homepage: `https://pypi.python.org/pypi/PyDrive2 <https://pypi.python.org/pypi/PyDrive2>`_
-- Documentation: `Official documentation on GitHub pages <https://iterative.github.io/PyDrive2/docs/build/html/index.html>`_
-- GitHub: `https://github.com/iterative/PyDrive2 <https://github.com/iterative/PyDrive2>`_
+- Package: `https://pypi.python.org/pypi/PyDrive2 <https://pypi.python.org/pypi/PyDrive2>`_
+- Documentation: `https://docs.iterative.ai/PyDrive2 <https://docs.iterative.ai/PyDrive2>`_
+- Source: `https://github.com/iterative/PyDrive2 <https://github.com/iterative/PyDrive2>`_
+- Changelog: `https://github.com/iterative/PyDrive2/releases <https://github.com/iterative/PyDrive2/releases>`_
 - `Running tests </pydrive2/test/README.rst>`_
 
 Features of PyDrive2

docs/README.md

@@ -0,0 +1,27 @@
+This document outlines how to rebuild the documentation.
+
+## Setup
+
+- Install Sphinx: `pip install sphinx` or `apt-get install python-sphinx`
+- Install theme: `pip install furo`
+- Build site: `sphinx-build docs dist/site -b dirhtml -a`
+
+Updating GitHub Pages:
+
+```bash
+cd dist/site
+git init
+git add .
+git commit -m "update pages"
+git branch -M gh-pages
+git push -f git@github.com:iterative/PyDrive2 gh-pages
+```
+
+## Contributing
+
+If code files were added, the easiest way to reflect code changes in the
+documentation by referencing the file from within `pydrive.rst`.
+
+If a non-code related file was added (it has to have the `.rst` ending),
+then add the file name to the list of names under "Table of Contents"
+in `index.rst`. Make sure to add the file name excluding the `.rst` file ending.