fix: Remove unmaintained sphinxcontrib-redoc

sphinxcontrib-redoc (latest release 1.6.0, unmaintained) imports the
pkg_resources module which setuptools removed in version 81.

The spec is already rendered natively on the rest_api page by the
maintained sphinxcontrib-openapi `.. openapi::` directive. It
doesn't look as nice as redoc but it will have to do.

Author: Your Name

doc/conf.py

@@ -12,15 +12,6 @@
     "sphinx.ext.napoleon",
     "sphinx.ext.viewcode",
     "sphinxcontrib.openapi",
-    "sphinxcontrib.redoc",
-]
-
-redoc = [
-    {
-        "name": "httpstan API",
-        "page": "api",
-        "spec": "openapi.yaml",
-    },
 ]
 
 source_suffix = ".rst"

doc/index.rst

@@ -116,7 +116,6 @@ User Guide
 .. _CmdStan: http://mc-stan.org/interfaces/cmdstan.html
 .. _PyStan: http://mc-stan.org/interfaces/pystan.html
 .. _Stan: http://mc-stan.org/
-.. _`OpenAPI documentation for httpstan`: api.html
 
 .. |pypi| image:: https://img.shields.io/pypi/v/httpstan.svg
     :target: https://pypi.org/project/httpstan/

doc/rest_api.rst

@@ -4,10 +4,7 @@ HTTP-based REST API
 Users interact with ``httpstan`` using an HTTP-based REST API. This page
 describes the API.
 
-An alternative single-page rendering of this documentation is available:
-`httpstan HTTP-based REST API <api.html>`_.
-
-This page and the alternative rendering are generated from an OpenAPI spec.
+This page is generated from an OpenAPI spec.
 This API uses conventions described in the document `API Design Guide <https://cloud.google.com/apis/design/>`_.
 
 .. openapi:: openapi.yaml

docs-requirements.txt

@@ -11,7 +11,6 @@ sphinx~=7.2 # BSD
 sphinx-autoapi~=3.0.0
 sphinx-rtd-theme~=2.0.0
 sphinxcontrib-openapi~=0.8.4
-sphinxcontrib-redoc~=1.6
 
 # required for building OpenAPI spec
 apispec[yaml]~=6.0

pyproject.toml

@@ -53,7 +53,6 @@ sphinx = "^7.2"
 sphinx-autoapi = "^3.0.0"
 sphinx-rtd-theme = "^2.0.0"
 sphinxcontrib-openapi = "^0.8.4"
-sphinxcontrib-redoc = "^1.6"
 
 [tool.black]
 line-length = 119