Adds github workflow to build docs

WIP commit.

Author: skrawcz

.github/workflows/sphinx-docs.yml

@@ -0,0 +1,52 @@
+name: Build Sphinx Documentation
+
+on:
+  push:
+    branches: [ main, update_references]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/sphinx-docs.yml'
+  pull_request:
+    branches: [ main, update_references ]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/sphinx-docs.yml'
+  workflow_dispatch:
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y graphviz
+    
+    - name: Upgrade pip and setuptools
+      run: |
+        python -m pip install --upgrade --no-cache-dir pip setuptools
+    
+    - name: Install Sphinx and dependencies
+      run: |
+        python -m pip install --upgrade --no-cache-dir sphinx sphinx-rtd-theme
+        python -m pip install --upgrade --upgrade-strategy only-if-needed --no-cache-dir .[docs]
+    
+    - name: Build Sphinx documentation
+      working-directory: ./docs
+      run: |
+        python -m sphinx -T -W --keep-going -b dirhtml -d _build/doctrees -D language=en . _build/html
+    
+    - name: Upload artifact
+      uses: actions/upload-artifact@v3
+      with:
+        name: sphinx-docs
+        path: docs/_build/html/
+        retention-days: 5