Squashed commit of the following:

commit 001dcde0805f8c718be767d9421975a9ee2a37df
Author: David Meyer <dihm@users.noreply.github.com>
Date:   Sun Aug 3 00:11:07 2025 -0400

    Merge pull request #110 from dihm/sphinx_update

    Update sphinx and fix RTD-stable versioning

commit dc835e621506a7f6cebcd542a4206eef92c19174
Author: David Meyer <dihm.meyer@gmail.com>
Date:   Tue Apr 29 14:15:31 2025 -0400

    Fix README shield link target

Author: dihm

README.md

@@ -8,7 +8,7 @@
 [![License](https://img.shields.io/pypi/l/blacs.svg)](https://github.com/labscript-suite/blacs/raw/master/LICENSE.txt)
 [![Python Version](https://img.shields.io/pypi/pyversions/blacs.svg)](https://python.org)
 [![PyPI](https://img.shields.io/pypi/v/blacs.svg)](https://pypi.org/project/blacs)
-[![Conda Version](https://img.shields.io/conda/v/labscript-suite/lyse)](https://anaconda.org/labscript-suite/blacs)
+[![Conda Version](https://img.shields.io/conda/v/labscript-suite/blacs)](https://anaconda.org/labscript-suite/blacs)
 [![Google Group](https://img.shields.io/badge/Google%20Group-labscriptsuite-blue.svg)](https://groups.google.com/forum/#!forum/labscriptsuite)
 <!--[![DOI](http://img.shields.io/badge/DOI-10.1063%2F1.4817213-0F79D0.svg)](https://doi.org/10.1063/1.4817213)-->
 

docs/Makefile

@@ -7,12 +7,18 @@ SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = source
 BUILDDIR      = build
+AUTOSUMMARYDIR = source/api/_autosummary
 
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
-.PHONY: help Makefile
+clean:
+	@echo "Removing autosummary directory"
+	@rm -rf $(AUTOSUMMARYDIR)
+	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help clean Makefile
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).

docs/make.bat

@@ -9,8 +9,10 @@ if "%SPHINXBUILD%" == "" (
 )
 set SOURCEDIR=source
 set BUILDDIR=build
+set AUTOSUMMARYDIR=source\api\_autosummary
 
 if "%1" == "" goto help
+if "%1" == "clean" goto clean
 
 %SPHINXBUILD% >NUL 2>NUL
 if errorlevel 9009 (
@@ -30,6 +32,12 @@ goto end
 
 :help
 %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:clean
+echo Removing autosummary directory
+rmdir /s/q %AUTOSUMMARYDIR%
+%SPHINXBUILD% -M clean %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
 
 :end
 popd

docs/source/api/index.rst

@@ -3,7 +3,6 @@ API Reference
 
 .. autosummary::
     :toctree: _autosummary
-    :template: autosummary-module.rst
     :recursive:
 
     blacs.analysis_submission

docs/source/conf.py

@@ -14,6 +14,7 @@
 import os
 from pathlib import Path
 from jinja2 import FileSystemLoader, Environment
+import importlib.metadata
 
 # -- Project information (unique to each project) -------------------------------------
 
@@ -22,7 +23,7 @@
 author = "labscript suite contributors"
 
 # The full version, including alpha/beta/rc tags
-from blacs import __version__ as version  # noqa: E402
+version = importlib.metadata.version('blacs')
 
 release = version
 
@@ -83,7 +84,10 @@
 exclude_patterns = []
 
 # The suffix(es) of source filenames.
-source_suffix = ['.rst', '.md']
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
 
 # The master toctree document.
 master_doc = 'index'
@@ -104,7 +108,7 @@
     'h5py': ('https://docs.h5py.org/en/stable/', None),
     'pydaqmx': ('https://pythonhosted.org/PyDAQmx/', None),
     'qt': (
-        '',
+        'https://riverbankcomputing.com/static/Docs/PyQt5/',
         'pyqt5-modified-objects.inv',
     )  # from https://github.com/MSLNZ/msl-qt/blob/master/docs/create_pyqt_objects.py
     # under MIT License

docs/source/index.rst

@@ -3,8 +3,8 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-blacs
-=====
+blacs |version|
+===============
 
 A graphical interface to scientific instruments and experiment supervision.
 

pyproject.toml

@@ -50,9 +50,9 @@ Tracker = "https://github.com/labscript-suite/blacs/issues/"
 [project.optional-dependencies]
 docs = [
     "PyQt5",
-    "Sphinx==7.2.6",
-    "sphinx-rtd-theme==2.0.0",
-    "myst_parser==2.0.0",
+    "Sphinx==8.2.3",
+    "sphinx-rtd-theme==3.0.2",
+    "myst_parser==4.0.1",
 ]
 
 [project.scripts]

readthedocs.yaml

@@ -9,6 +9,13 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.11"
+  jobs:
+    # ensure full git repo is pulled so setuptools_scm gets versions correctly on install
+    # https://docs.readthedocs.com/platform/stable/build-customization.html#unshallow-git-clone
+    post_checkout:
+      - git fetch --unshallow || true
+      - git config remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*' || true
+      - git fetch --all --tags || true
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx: