Added github action to build docs and publish website

Author: andrewherren

.github/workflows/docs.yml

@@ -0,0 +1,55 @@
+# Combination of https://github.com/RobinMagnet/pyFM/blob/master/.github/workflows/documentation.yml
+# and https://github.com/r-lib/pkgdown/blob/main/.github/workflows/pkgdown.yaml
+name: docs
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build_documentation:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        submodules: 'recursive'
+
+    - name: Setup Python 3.10
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+        cache: "pip"
+
+    - name: Install Package with Relevant Dependencies
+      run: |
+        pip install --upgrade pip
+        pip install -r docs/requirements.txt
+        pip install .
+
+    - name: Build HTML
+      run: |
+        sphinx-build -M html docs/source/ docs/_build/
+
+    - name: Upload Artifact
+      uses: actions/upload-artifact@v4
+      with:
+        path:
+          docs/_build/html/
+    
+    - name: Deploy to GitHub Pages
+      uses: peaceiris/actions-gh-pages@v4
+      if: github.ref == 'refs/heads/main'
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: docs/_build/html