docs: restructure sphinx documentation

Author: afuetterer

.github/workflows/documentation.yml

@@ -29,21 +29,22 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Install dependencies
-        run: |
-          pip install sphinx furo myst-parser
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+      - run: python -m pip install --upgrade pip
+      - run: python -m pip install sphinx furo myst-parser
       - name: Sphinx APIDoc
         run: |
-          sphinx-apidoc -f -o docs/source/ .
+          sphinx-apidoc --force -o docs/source/ .
       - name: Sphinx build
         run: |
-          sphinx-build -b html docs/source/ docs/build/html
+          sphinx-build --builder html docs/source/ docs/build/html
       - name: Setup Pages
         uses: actions/configure-pages@v5
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v4
         with:
           # Upload entire repository
           path: './docs/build/html'