Update CI workflows for autodoc & add separate jobs with/wo

Author: CAM-Gerlach

.github/workflows/build.yaml

@@ -20,18 +20,26 @@ permissions:
 
 jobs:
   build:
-    name: Build and Deploy
+    name: Build and Deploy Autodoc=${{ matrix.build-autodoc }}
 
     runs-on: ubuntu-latest
 
     env:
       IS_DEPLOY: ${{ (github.event_name == 'push' && '1') || '0' }}
       IS_STAGING: ${{ (github.ref == 'refs/heads/staging' && '1') || '0' }}
       IS_MAIN: ${{ ((github.ref == 'refs/heads/main' || github.ref == 'refs/heads/master') && '1') || '0' }}
+      BUILD_AUTODOC: ${{ matrix.build-autodoc }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        build-autodoc: ['Yes', 'No']
 
     steps:
     - name: Check out repository
       uses: actions/checkout@v4
+      with:
+        submodules: true
     - name: Set up Python
       uses: actions/setup-python@v5
       with:
@@ -45,12 +53,13 @@ jobs:
         echo Deploy: $IS_DEPLOY
         echo Prod: $IS_PROD
         echo Main: $IS_MAIN
+        echo Autodoc: $BUILD_AUTODOC
         pip list
     - name: Build project
       shell: bash
       run: ./ci/build.sh
     - name: Deploy to GitHub Pages
-      if: env.IS_DEPLOY == '1'
+      if: env.IS_DEPLOY == '1' && env.BUILD_AUTODOC == 'Yes'
       uses: JamesIves/github-pages-deploy-action@v4
       with:
         folder: docs/_build/html

.github/workflows/check.yaml

@@ -31,6 +31,8 @@ jobs:
     steps:
     - name: Checkout repository
       uses: actions/checkout@v4
+      with:
+        submodules: true
     - name: Set up Python
       uses: actions/setup-python@v5
       with:

ci/build.sh

@@ -1,3 +1,9 @@
 #!/bin/bash -ex
 
-nox -s build
+if [ "$BUILD_AUTODOC" = "No" ]; then
+    ARGS=''
+else
+    ARGS='-t autodoc'
+fi
+
+nox -s build -- $ARGS