fix: document module extensions, not workspace repositories

.github/workflows/release_docs.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+# Add generated API docs to the release
+# see https://github.com/bazelbuild/bazel-central-registry/blob/main/docs/stardoc.md
+set -o errexit -o nounset -o pipefail
+
+docs="$(mktemp -d)"
+targets="$(mktemp)"
+out=$1
+bazel --output_base="$docs" query --output=label --output_file="$targets" 'kind("starlark_doc_extract rule", //...)'
+bazel --output_base="$docs" build --target_pattern_file="$targets"
+tar --create --auto-compress \
+    --directory "$(bazel --output_base="$docs" info bazel-bin)" \
+    --file "${out}" .

.github/workflows/release_prep.sh

@@ -50,8 +50,6 @@ tar --create --auto-compress \
     --file "$GITHUB_WORKSPACE/${ARCHIVE%.tar.gz}.docs.tar.gz" .
 
 cat << EOF
-## Using [Bzlmod] with Bazel 6:
-
 Add to your \`MODULE.bazel\` file:
 
 \`\`\`starlark
@@ -67,36 +65,4 @@ python.toolchain(
 )
 \`\`\`
 
-[Bzlmod]: https://bazel.build/build/bzlmod
-
-## Using WORKSPACE
-
-\`\`\`starlark
-load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
-http_archive(
-    name = "aspect_rules_py",
-    sha256 = "${SHA}",
-    strip_prefix = "${PREFIX}",
-    url = "https://github.com/aspect-build/rules_py/releases/download/${TAG}/${ARCHIVE}",
-)
-
-load("@aspect_rules_py//py:repositories.bzl", "rules_py_dependencies")
-
-rules_py_dependencies()
-
-load("@aspect_rules_py//py:toolchains.bzl", "rules_py_toolchains")
-
-rules_py_toolchains()
-
-# "Installation" for rules_python
-load("@rules_python//python:repositories.bzl", "py_repositories", "python_register_toolchains")
-
-python_register_toolchains(
-    name = "python_toolchain",
-    python_version = "3.9",
-)
-
-py_repositories()
-\`\`\`
-
 EOF

BUILD.bazel

@@ -1,5 +1,7 @@
 load("@gazelle//:def.bzl", "gazelle")
 load("@rules_python//python/pip_install:requirements.bzl", "compile_pip_requirements")
+
+# buildifier: disable=bzl-visibility
 load("//uv/private/manifest:defs.bzl", "gazelle_python_manifest")
 
 # gazelle:exclude internal_python_deps.bzl

py/BUILD.bazel

@@ -3,24 +3,13 @@ load("@bazel_lib//:bzl_library.bzl", "bzl_library")
 # For Bazel 6.x compatibility, since
 # PyRuntimeInfo shipped only with Bazel 7
 # Users can set, e.g. --@aspect_rules_py//py:interpreter_version=3.9.18
+# TODO(2.0): remove since Bazel 6 is no longer LTS
 alias(
     name = "interpreter_version",
     actual = "@rules_python//python/config_settings:python_version",
     visibility = ["//visibility:public"],
 )
 
-bzl_library(
-    name = "repositories",
-    srcs = ["repositories.bzl"],
-    visibility = ["//visibility:public"],
-    deps = [
-        "//py/private/toolchain:autodetecting",
-        "@bazel_tools//tools/build_defs/repo:cache.bzl",
-        "@bazel_tools//tools/build_defs/repo:http.bzl",
-        "@bazel_tools//tools/build_defs/repo:utils.bzl",
-    ],
-)
-
 bzl_library(
     name = "defs",
     srcs = ["defs.bzl"],
@@ -39,20 +28,16 @@ bzl_library(
     ],
 )
 
-# This needs to dep on @aspect_tools_telemetry_report but we don't have that in WORKSPACE
-# gazelle:exclude extensions.bzl
-# bzl_library(
-#     name = "extensions",
-#     srcs = [
-#         "extensions.bzl",
-#         "@aspect_tools_telemetry_report//:defs.bzl",
-#     ],
-#     visibility = ["//visibility:public"],
-#     deps = [
-#         ":toolchains",
-#         "//py/private/release:version",
-#     ],
-# )
+bzl_library(
+    name = "extensions",
+    srcs = ["extensions.bzl"],
+    visibility = ["//visibility:public"],
+    deps = [
+        ":toolchains",
+        "//py/private/release:version",
+        "@aspect_tools_telemetry_report//:defs.bzl",
+    ],
+)
 
 bzl_library(
     name = "toolchains",