Add mkdocs site with API reference and GitHub Pages deployment

Set up mkdocs-material with mkdocstrings to auto-generate API docs from
docstrings across all 18 api modules. Add GitHub Actions workflow to
build and deploy to GitHub Pages on push to main.

Author: michelp

.github/workflows/docs.yml

@@ -0,0 +1,20 @@
+name: docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install mkdocs-material "mkdocstrings[python]"
+      - run: mkdocs gh-deploy --force

docs/api/binaryop.md

@@ -0,0 +1,3 @@
+# BinaryOp
+
+::: suitesparse_graphblas.api.binaryop

docs/api/container.md

@@ -0,0 +1,3 @@
+# Container
+
+::: suitesparse_graphblas.api.container

docs/api/context.md

@@ -0,0 +1,3 @@
+# Context
+
+::: suitesparse_graphblas.api.context

docs/api/descriptor.md

@@ -0,0 +1,3 @@
+# Descriptor
+
+::: suitesparse_graphblas.api.descriptor

docs/api/global_.md

@@ -0,0 +1,3 @@
+# Global
+
+::: suitesparse_graphblas.api.global_

docs/api/global_options.md

@@ -0,0 +1,3 @@
+# Global Options
+
+::: suitesparse_graphblas.api.global_options

docs/api/grb_type.md

@@ -0,0 +1,3 @@
+# Type
+
+::: suitesparse_graphblas.api.grb_type

docs/api/indexbinaryop.md

@@ -0,0 +1,3 @@
+# IndexBinaryOp
+
+::: suitesparse_graphblas.api.indexbinaryop

docs/api/indexunaryop.md

@@ -0,0 +1,3 @@
+# IndexUnaryOp
+
+::: suitesparse_graphblas.api.indexunaryop