Cleanup and disable linkcheck

.github/workflows/docs.yml

@@ -32,9 +32,9 @@ jobs:
           python-version: 3.8
       - run: python -m pip install --upgrade pip
       - run: python -m pip install -r requirements/ci.txt
-      - run: tox --skip-pkg-install -e docs2 scippnexus
+      - run: tox --skip-pkg-install -e docs scippnexus
         if: ${{ github.event.inputs.publish == 'true' || inputs.publish }}
-      - run: tox -e docs2
+      - run: tox -e docs
         if: ${{ !(github.event.inputs.publish == 'true' || inputs.publish) }}
       - uses: actions/upload-artifact@v3
         with:

tox.ini

@@ -12,26 +12,20 @@ basepython = python3.8
 deps = -r requirements/test-lowest.txt
 commands = pytest
 
-[testenv:docs2]
+[testenv:docs]
 description = invoke sphinx-build to build the HTML docs
 basepython = python3.8
-deps =
-  {posargs:}
-  -r requirements/docs.txt
+deps = {posargs:}
+       -r requirements/docs.txt
 allowlist_externals=find
 commands = python -m sphinx -j2 -v -b html -d {toxworkdir}/docs_doctrees docs html
            python -m sphinx -j2 -v -b doctest -d {toxworkdir}/docs_doctrees docs html
            find html -type f -name "*.ipynb" -not -path "html/_sources/*" -delete
 
-[testenv:docs]
-description = invoke sphinx-build to build the HTML docs
-basepython = python3.8
+[testenv:linkcheck]
+description = Run Sphinx linkcheck
 deps = -r requirements/docs.txt
-allowlist_externals=find
-commands = python -m sphinx -j2 -v -b html -d {toxworkdir}/docs_doctrees docs html
-           python -m sphinx -j2 -v -b doctest -d {toxworkdir}/docs_doctrees docs html
-           python -m sphinx -j2 -v -b linkcheck -d {toxworkdir}/docs_doctrees docs html
-           find html -type f -name "*.ipynb" -not -path "html/_sources/*" -delete
+commands = python -m sphinx -j2 -v -b linkcheck -d {toxworkdir}/docs_doctrees docs html
 
 [testenv:static]
 description = Code formatting and static analysis