CHanges learned while working on docs for OneMod

.github/workflows/deploy.yml

@@ -30,6 +30,8 @@ jobs:
         password: ${{ secrets.PYPI_API_TOKEN }}
 
   docs:
+    environment:
+      name: github-pages
     runs-on: ubuntu-latest
     permissions:
       pages: write
@@ -41,19 +43,18 @@ jobs:
         with:
           python-version: "3.12"
       - name: Install dependencies
-        run: python -m pip install .[docs] --upgrade pip
+        run: |
+          python -m pip install .[docs] --upgrade pip
+          pip install sphinx sphinx-rtd-theme
       - name: Generate API docs & Build sphinx documentation
         run: |
-          git fetch --tags
-          cd docs
-          python build.py
-          cd ..
+          sphinx-build -M html docs docs-out
       - name: Setup Pages
         uses: actions/configure-pages@v5
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: './docs/pages'
+          path: './docs-out/html'
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4