polish docs (#230)

* polish docs

* improve guppy-hugr handling

* improve multiprocessing handling

Author: ciaranra

.github/workflows/python-test.yml

@@ -24,12 +24,23 @@ defaults:
 jobs:
   python-test:
     runs-on: ${{ matrix.os }}
-    timeout-minutes: 90
+    timeout-minutes: 240
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macOS-latest]
+        # Full Python version matrix on Ubuntu (fast)
+        os: [ubuntu-latest]
         python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        include:
+          # Windows/macOS: only test oldest and newest stable Python (slow platforms)
+          - os: windows-latest
+            python-version: "3.10"
+          - os: windows-latest
+            python-version: "3.14"
+          - os: macOS-latest
+            python-version: "3.10"
+          - os: macOS-latest
+            python-version: "3.14"
 
     steps:
     - name: Free Disk Space (Ubuntu)
@@ -139,6 +150,13 @@ jobs:
         Write-Host "Verifying LLVM installation..."
         cargo run -p pecos --features cli --release -- llvm check
 
+    - name: Install PECOS CLI (Windows)
+      if: runner.os == 'Windows'
+      shell: pwsh
+      run: |
+        Write-Host "Installing PECOS CLI..."
+        cargo install --path crates/pecos --features cli
+
     - name: Build and test PECOS (Windows)
       if: runner.os == 'Windows'
       shell: pwsh
@@ -225,6 +243,12 @@ jobs:
         just build-debug
         just pytest-all
 
+    - name: Install PECOS CLI (non-Windows)
+      if: runner.os != 'Windows'
+      run: |
+        echo "Installing PECOS CLI..."
+        cargo install --path crates/pecos --features cli
+
     - name: Build and test PECOS (non-Windows)
       if: runner.os != 'Windows'
       run: |

.gitignore

@@ -12,6 +12,12 @@ tmp/
 # pytest results
 junit/
 
+# Generated doc tests (from scripts/docs/generate_doc_tests.py)
+python/quantum-pecos/tests/docs/generated/
+
+# Generated WASM binaries (compile from .wat source)
+*.wasm
+
 # Cython
 *.pyc
 *.pyd

.pre-commit-config.yaml

@@ -41,8 +41,9 @@ repos:
       - id: black
 
   - repo: https://github.com/keewis/blackdoc
-    rev: v0.4.1
+    rev: v0.4.6
     hooks:
     -   id: blackdoc
+        args: [--line-length=120]
         additional_dependencies:
-        - black==25.1.0
+        - black==25.9.0

.typos.toml

@@ -25,3 +25,10 @@ arange = "arange"
 nd = "nd"
 # delocate is a macOS wheel repair tool (delocate-wheel command)
 delocate = "delocate"
+# Gate name breakdown notation uses partial words like C(ontrolled), R(otation)
+ontrolled = "ontrolled"
+otation = "otation"
+repare = "repare"
+easure = "easure"
+egative = "egative"
+agger = "agger"