Add docs build instructions and workflow for GH pages

Author: melissawm

.github/workflows/build_docs.yml

@@ -0,0 +1,42 @@
+name: Build Docs
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:  # Make sure this job can be triggered manually
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/configure-pages@v3
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - name: Install dependencies
+        run: |
+          cd quaddtype/
+          python -m pip install --upgrade pip
+          python -m pip install "numpy @ git+https://github.com/numpy/numpy.git" pytest meson meson-python
+      - name: Build quaddtype package
+        run: |
+          cd quaddtype/
+          python -m pip install . -v --no-build-isolation
+      - name: Build Sphinx documentation
+        run: |
+          cd quaddtype/
+          python -m pip install ."[docs]"
+          make -C docs html
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './quaddtype/docs/_build/html'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

quaddtype/README.md

@@ -171,3 +171,36 @@ This is a development feature to help detect threading issues. To build `numpy-q
   export LDFLAGS="-fsanitize=thread"
   python -m pip install . -vv --no-build-isolation -Csetup-args=-Db_sanitize=thread
   ```
+
+## Building the documentation
+
+The documentation for the `numpy-quaddtype` package is built using Sphinx. To build the documentation, follow these steps:
+
+1. Install the required dependencies:
+
+   ```bash
+   pip install ."[docs]"
+   ```
+
+2. Navigate to the `docs` directory and build the documentation:
+
+   ```bash
+   cd docs/
+   make html
+   ```
+
+3. The generated HTML documentation can be found in the `_build/html` directory within the `docs` folder. Open the `index.html` file in a web browser to view the documentation, or use a local server to serve the files:
+
+   ```bash
+   python3 -m http.server --directory _build/html
+   ```
+
+### Serving the documentation
+
+The documentation is automatically built and served using GitHub Pages. Every time changes are pushed to the `main` branch, the documentation is rebuilt and deployed to the `gh-pages` branch of the repository. You can access the documentation at:
+
+```
+https://numpy.github.io/numpy-user-dtypes/
+```
+
+Check the `.github/workflows/build_docs.yml` file for details.

quaddtype/docs/conf.py

@@ -26,4 +26,4 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = 'pydata_sphinx_theme'
-html_static_path = ['_static']
+