Use correct mock for h5_lock, tweak makefiles, and fix cross-ref

Author: dihm

docs/Makefile

@@ -7,14 +7,14 @@ SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = source
 BUILDDIR      = build
-AUTOSUMMARYDIR = source/api/_autosummary
+AUTOSUMMARYDIR = source/devices/_apidoc
 
 # Put it first so that "make" without argument is like "make help".
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 clean:
-	@echo "Removing autosummary directory"
+	@echo "Removing apidoc directory"
 	@rm -rf $(AUTOSUMMARYDIR)
 	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 

docs/make.bat

@@ -9,7 +9,7 @@ if "%SPHINXBUILD%" == "" (
 )
 set SOURCEDIR=source
 set BUILDDIR=build
-set AUTOSUMMARYDIR=source\api\_autosummary
+set AUTOSUMMARYDIR=source\devices\_apidoc
 
 if "%1" == "" goto help
 if "%1" == "clean" goto clean

docs/source/conf.py

@@ -50,7 +50,7 @@
 
 autodoc_typehints = 'description'
 autoclass_content = 'both'  # options: 'both', 'class', 'init'
-autodoc_mock_imports = ['PyDAQmx','labscript_utils']
+autodoc_mock_imports = ['PyDAQmx','labscript_utils.h5_lock']
 
 # Prefix each autosectionlabel with the name of the document it is in and a colon
 autosectionlabel_prefix_document = True

docs/source/user_devices.rst

@@ -32,4 +32,4 @@ Please direct any questions regarding these repositories to their respective own
 * `NAQS Lab <https://github.com/naqslab/naqslab_devices>`__
 * `Vladan Vuletic Group Rb Lab, MIT <https://github.com/zakv/RbLab_user_devices>`__
 
-If you would like to add your repository to this list, :doc:`please contact us or make a pull request<labscript-suite:contributing>`.
+If you would like to add your repository to this list, :doc:`please contact us or make a pull request<labscript-suite:project/contributing>`.