PYTHON-3381 Improve readability of sphinx docs (mongodb#1156)

blink1073 · web-flow · commit 6e2e70ab803e · 2023-02-17T08:31:57.000-06:00
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -24,7 +24,7 @@ repos:
     args: [--line-length=100]
 
 - repo: https://github.com/PyCQA/isort
-  rev: 5.10.1
+  rev: 5.12.0
   hooks:
   - id: isort
     files: \.py$
diff --git a/doc/changelog.rst b/doc/changelog.rst
@@ -3519,9 +3519,3 @@ Changes in Version 0.9.7
   :class:`~pymongo.collection.Collection` names
 - add version as :attr:`pymongo.version`
 - add ``--no_ext`` command line option to *setup.py*
-
-.. toctree::
-   :hidden:
-
-   python3
-   examples/gevent
diff --git a/doc/common-issues.rst b/doc/common-issues.rst
@@ -3,8 +3,6 @@ Frequently Encountered Issues
 
 Also see the :ref:`TLSErrors` section.
 
-.. contents::
-
 Server reports wire version X, PyMongo requires Y
 -------------------------------------------------
 
diff --git a/doc/conf.py b/doc/conf.py
@@ -32,7 +32,6 @@
 except ImportError:
     pass
 
-
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
@@ -108,13 +107,18 @@
 
 # -- Options for HTML output ---------------------------------------------------
 
-# Theme gratefully vendored from CPython source.
-html_theme = "pydoctheme"
-html_theme_path = ["."]
-html_theme_options = {"collapsiblesidebar": True, "googletag": False}
+try:
+    import furo  # noqa
+
+    html_theme = "furo"
+except ImportError:
+    # Theme gratefully vendored from CPython source.
+    html_theme = "pydoctheme"
+    html_theme_path = ["."]
+    html_theme_options = {"collapsiblesidebar": True, "googletag": False}
 
-# Additional static files.
-html_static_path = ["static"]
+    # Additional static files.
+    html_static_path = ["static"]
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
diff --git a/doc/docs-requirements.txt b/doc/docs-requirements.txt
@@ -1,4 +1,5 @@
-Sphinx~=4.2
+Sphinx~=6.1
 sphinx_rtd_theme~=0.5
 readthedocs-sphinx-search~=0.1
 sphinxcontrib-shellcheck~=1.1
+furo==2022.12.7
diff --git a/doc/faq.rst b/doc/faq.rst
@@ -1,8 +1,6 @@
 Frequently Asked Questions
 ==========================
 
-.. contents::
-
 Is PyMongo thread-safe?
 -----------------------
 
diff --git a/doc/migrate-to-pymongo4.rst b/doc/migrate-to-pymongo4.rst
@@ -3,8 +3,6 @@
 PyMongo 4 Migration Guide
 =========================
 
-.. contents::
-
 .. testsetup::
 
   from pymongo import MongoClient, ReadPreference
diff --git a/doc/python3.rst b/doc/python3.rst
@@ -1,8 +1,6 @@
 Python 3 FAQ
 ============
 
-.. contents::
-
 What Python 3 versions are supported?
 -------------------------------------
 
