Validating pull request builds

.github/workflows/build-artifact.yml

@@ -41,6 +41,8 @@ jobs:
 
     - name: Build Sphinx docs
       run: poetry run sphinx-build -M dirhtml . _build
+      env:
+        GIT_REF: ${{ github.head_ref }}
 
     - name: Run Vale
       uses: docker://jdkato/vale

conf.py

@@ -3,6 +3,8 @@
 # For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
+import os
+
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
@@ -48,7 +50,7 @@
 html_title = "Business Process Manual"
 html_theme_options = {
     "source_repository": "https://github.com/RoboJackets/business-process-manual/",
-    "source_branch": "main",
+    "source_branch": os.environ.get("GIT_REF", "main"),
     "source_directory": "/",
     "footer_icons": [
         {

index.rst

@@ -15,6 +15,10 @@
 
    nested-directory/index
 
+.. todolist::
+
+.. todo:: something
+
 
 Indices and tables
 ==================