Use theme release 0.5.0rc2 for docs

* Upgrade Sphinx to 3.0.4
* Redo some of our doc requirements files to make them less complicated

Author: agjohnson

.readthedocs.yml

@@ -3,5 +3,6 @@ formats: all
 sphinx:
   configuration: docs/conf.py
 python:
-   install:
-      - requirements: requirements/local-docs-build.txt
+  install:
+    - requirements: requirements/pip.txt
+    - requirements: requirements/docs.txt

docs/development/docs.rst

@@ -10,7 +10,7 @@ Follow the instructions just up to the point of activating the virtual environme
 
 Next, install the documentation dependencies using ``pip`` (make sure you are inside of the virtual environment)::
 
-    pip install -r requirements/local-docs-build.txt
+    pip install -r requirements/docs.txt
 
 This installs ``Sphinx``, amongst other things.
 

requirements/local-docs-build.txt renamed to requirements/docs.txt

@@ -1,6 +1,6 @@
--r pip.txt
+# Packages required to build docs, independent of application dependencies
 
-# Base packages
+Sphinx==3.0.4
 
 # doctuils==0.15 produces this error
 #   File "python3.6/site-packages/docutils/parsers/rst/states.py", line 882, in interpreted
@@ -10,19 +10,16 @@
 # AttributeError: 'str' object has no attribute 'rawsource'
 docutils==0.14  # pyup: ignore
 
-sphinx_rtd_theme==0.4.3
+sphinx_rtd_theme==0.5.0rc2
 sphinx-tabs==1.1.13
-# Required to avoid Transifex error with reserved slug
-# https://github.com/sphinx-doc/sphinx-intl/pull/27
-git+https://github.com/agjohnson/sphinx-intl.git@7b5c66bdb30f872b3b1286e371f569c8dcb66de5#egg=sphinx-intl
+sphinx-intl==2.0.1
 
 # Test out in-doc search
 git+https://github.com/readthedocs/readthedocs-sphinx-search@master
 
 # Test out hoverxref
 git+https://github.com/readthedocs/sphinx-hoverxref@master
 
-
 Pygments==2.6.1
 
 mkdocs==1.1
@@ -34,3 +31,6 @@ sphinx-prompt==1.0.0
 sphinx-notfound-page==0.4
 commonmark==0.9.1
 recommonmark==0.6.0
+
+# Linting
+rstcheck==3.3.1

tox.ini

@@ -48,7 +48,7 @@ commands =
 
 [testenv:docs-lint]
 description = run linter (rstcheck) to ensure there aren't errors on our docs
-deps = -r{toxinidir}/requirements/docs-lint.txt
+deps = -r{toxinidir}/requirements/docs.txt
 changedir = {toxinidir}/docs
 commands =
     rstcheck -r .