Update docs theme and remove docs env pins (#695)

Author: jacobtomlinson

.gitignore

@@ -137,3 +137,4 @@ ci/slurm/environment.yml
 ci/pbs/environment.yml
 ci/sge/environment.yml
 ci/htcondor/environment.yml
+docs/generated/

dask_jobqueue/core.py

@@ -663,7 +663,7 @@ def __init__(
         job_kwargs["interface"] = interface
         job_kwargs["protocol"] = protocol
         job_kwargs["security"] = self._get_worker_security(security)
-        
+
         self.queue = queue
         if queue is not None:
             job_kwargs["queue"] = queue

docs/requirements-docs.txt

@@ -1,15 +1,6 @@
 distributed
 numpydoc
 ipython
-sphinx<5
+sphinx>=8
 sphinx-reredirects
-dask-sphinx-theme>=3.0.0
-# FIXME: This workaround is required until we have sphinx>=5, as enabled by
-#        dask-sphinx-theme no longer pinning sphinx-book-theme==0.2.0. This is
-#        tracked in https://github.com/dask/dask-sphinx-theme/issues/68.
-#
-sphinxcontrib-applehelp<1.0.5
-sphinxcontrib-devhelp<1.0.6
-sphinxcontrib-htmlhelp<2.0.5
-sphinxcontrib-serializinghtml<1.1.10
-sphinxcontrib-qthelp<1.0.7
+dask-sphinx-theme>=4.0.0

docs/source/conf.py

@@ -40,7 +40,6 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["sphinx.ext.autodoc", "sphinx.ext.intersphinx", "sphinx.ext.mathjax"]
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.mathjax",
@@ -210,6 +209,6 @@
 # Link to GitHub issues and pull requests using :pr:`1234` and :issue:`1234`
 # syntax
 extlinks = {
-    "issue": ("https://github.com/dask/dask-jobqueue/issues/%s", "GH#"),
-    "pr": ("https://github.com/dask/dask-jobqueue/pull/%s", "GH#"),
+    "issue": ("https://github.com/dask/dask-jobqueue/issues/%s", "GH#%s"),
+    "pr": ("https://github.com/dask/dask-jobqueue/pull/%s", "GH#%s"),
 }

readthedocs.yml

@@ -7,7 +7,7 @@ version: 2
 build:
   os: "ubuntu-22.04"
   tools:
-    python: "3.10"
+    python: "3.12"
 
 sphinx:
   configuration: docs/source/conf.py