DEV - Miscellaneous enhancements to CI

.github/actions/set-dev-env/action.yml

@@ -9,7 +9,13 @@ inputs:
   pandoc:
     description: Whether this should install pandoc or not
     required: false
-    default: "False"
+    type: boolean
+    default: false
+  graphviz:
+    description: Whether this should install pandoc or not
+    required: false
+    type: boolean
+    default: false
 
 runs:
   using: composite
@@ -30,3 +36,22 @@ runs:
     - name: "Install pandoc 📝"
       uses: 12rambau/setup-pandoc@test
       if: ${{ inputs.pandoc }} == true
+
+    - name: "Install Graphviz on Windows 🗔"
+      if: runner.os == 'Windows' && ${{ inputs.graphviz }} == true
+      shell: bash
+      run: choco install graphviz
+
+    - name: "Install Graphviz on macOS "
+      if: runner.os == 'macOS' && ${{ inputs.graphviz }} == true
+      shell: bash
+      run: |
+        brew update
+        brew install graphviz
+
+    - name: "Install Graphviz on Linux 🐧"
+      if: runner.os == 'Linux' && ${{ inputs.graphviz }} == true
+      shell: bash
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y --no-install-recommends graphviz

.github/workflows/CI.yml

@@ -103,6 +103,7 @@ jobs:
         uses: ./.github/actions/set-dev-env
         with:
           python-version: ${{ env.DEFAULT_PYTHON_VERSION }}
+          graphviz: true
       - name: "Run accessibility tests with playwright 🎭"
         # build PST, build docs, then run a11y-tests
         run: python -Im tox run -e py312-docs,a11y-tests
@@ -129,19 +130,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           pandoc: true
-      - name: "Install Graphviz on Windows 🗔"
-        if: runner.os == 'Windows'
-        run: choco install graphviz
-      - name: "Install Graphviz on macOS "
-        if: runner.os == 'macOS'
-        run: |
-          brew update
-          brew install graphviz
-      - name: "Install Graphviz on Linux 🐧"
-        if: runner.os == 'Linux'
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y --no-install-recommends graphviz
+          graphviz: true
       - name: "Build docs and check for warnings 📖"
         shell: bash
         run: |
@@ -191,6 +180,9 @@ jobs:
     name: "check coverage"
     needs: run-pytest
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
     steps:
       - name: "Checkout repository 🛎"
         uses: actions/checkout@v4

docs/community/setup.md

@@ -122,8 +122,10 @@ The caveat to using `tox` is that this will not install the required hooks to ru
 
 ## Build the documentation
 
-Now that you have `tox` installed and cloned the repository, you should be able to build the documentation locally.
+Now that you have `tox` installed and cloned the repository, you will need to install Graphviz to build the documentation.
+To install Graphviz, follow the instructions in the [Graphviz documentation for your operating system](https://graphviz.org/download/).
 
+Once you have `tox` and Graphviz installed, you can build the documentation.
 To build the documentation with `tox`, run the following command:
 
 ```console