Merge branch 'main' into fix-typo-dropping-versions

Author: woodruffw

.pre-commit-config.yaml

@@ -39,5 +39,5 @@ repos:
 - repo: https://github.com/astral-sh/ruff-pre-commit
   rev: v0.14.10
   hooks:
-    - id: ruff
+    - id: ruff-check
     - id: ruff-format

source/conf.py

@@ -148,6 +148,8 @@
     # Ignore while StackOverflow is blocking GitHub CI. Ref:
     # https://github.com/pypa/packaging.python.org/pull/1474
     r"https://stackoverflow\.com/.*",
+    # Cloudflare challenge blocks automated link checking.
+    r"https://clickpy\.clickhouse\.com/$",
     r"https://pyscaffold\.org/.*",
     r"https://anaconda\.org",
     r"https://www\.cisa\.gov/sbom",

source/overview.rst

@@ -279,7 +279,7 @@ A similar model involves installing an alternative Python
 distribution, but does not support arbitrary operating system-level
 packages:
 
-* `ActiveState ActivePython <https://www.activestate.com/products/python/>`_
+* `ActiveState ActivePython <https://www.activestate.com/platform/supported-languages/python>`_
 * `WinPython <http://winpython.github.io/>`_
 
 .. _bringing-your-own-python:

source/shared/build-backend-tabs.rst

@@ -38,5 +38,5 @@
     .. code-block:: toml
 
         [build-system]
-        requires = ["uv_build >= 0.11.23, <0.12.0"]
+        requires = ["uv_build >= 0.11.32, <0.12.0"]
         build-backend = "uv_build"

source/specifications/inline-script-metadata.rst

@@ -70,6 +70,17 @@ and the regular expression, the text specification takes precedence.
 Tools MUST NOT read from metadata blocks with types that have not been
 standardized by this specification.
 
+Note that the specification only requires that *top-level* comment blocks are
+recognised as containing metadata. However, parsing Python code is non-trivial,
+and therefore:
+
+* Tools MAY choose to do a simple textual scan, rather than a full Python parse.
+* As a result of the previous point, the behaviour of scripts that contain data
+  that looks like metadata within another Python construct such as a multi-line
+  string is tool-dependent and should not be relied on.
+* The canonical regular expression provided above is an example of an
+  implementation that does a simple textual scan.
+
 script type
 -----------