wip

Author: nedbat

.github/workflows/kit.yml

@@ -15,9 +15,6 @@
 #   $ piprepo build /tmp/pypi
 #   $ python -m pip install -v coverage --index-url=file:///tmp/pypi/simple
 #
-# Note that cibuildwheel recommends not shipping wheels for pre-release versions
-# of Python: https://cibuildwheel.readthedocs.io/en/stable/options/#prerelease-pythons
-# So we don't.
 
 name: "Kits"
 
@@ -82,6 +79,9 @@ jobs:
           #   }
           #   # PYVERSIONS. Available versions: https://pypi.org/project/cibuildwheel/
           #   # PyPy versions are handled further below in the "pypy" step.
+          #   # Note that cibuildwheel recommends not shipping wheels for pre-release versions
+          #   # of Python: https://cibuildwheel.readthedocs.io/en/stable/options/#enable
+          #
           #   pys = ["cp39", "cp310", "cp311", "cp312", "cp313"]
           #
           #   # Some OS/arch combinations need overrides for the Python versions:
@@ -150,6 +150,12 @@ jobs:
           - {"os": "windows", "py": "cp312", "arch": "ARM64", "os-version": "11-arm", "minpy": "3.11"}
           - {"os": "windows", "py": "cp313", "arch": "ARM64", "os-version": "11-arm", "minpy": "3.11"}
         # [[[end]]] (checksum: ce8e88f33d7db22f1e21a767e3256a00)
+        #            ^^^^^^^^
+        # If a check fails and points to this checksum line, it means you edited
+        # the matrix directly instead of editing the Python code in the comment
+        # above it.  The matrix is generated by running cog as described at the
+        # top of that comment.
+
       fail-fast: false
 
     steps:
@@ -165,7 +171,9 @@ jobs:
           cache: pip
           cache-dependency-path: 'requirements/*.pip'
 
-      # rust toolchain is not currently installed on windows arm64 images https://github.com/actions/partner-runner-images/issues/77
+      # Rust toolchain is not currently installed on windows arm64 images.
+      # We need it for nh3, needed by readme-renderer, needed by twine.
+      # https://github.com/actions/partner-runner-images/issues/77
       - if: ${{ matrix.os-version == '11-arm' }}
         name: Setup rust
         id: setup-rust
@@ -174,7 +182,7 @@ jobs:
           Invoke-WebRequest https://static.rust-lang.org/rustup/dist/aarch64-pc-windows-msvc/rustup-init.exe -OutFile .\rustup-init.exe
           .\rustup-init.exe -y
           Add-Content $env:GITHUB_PATH "$env:USERPROFILE\.cargo\bin"
-      
+
       - name: "Install tools"
         run: |
           python -m pip install -r requirements/kit.pip