docs: update for 1.6 release (#3205)

Doc updates for 1.6 release

Work towards https://github.com/bazel-contrib/rules_python/issues/3188

CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0ab4420..fc3d7bb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -47,12 +47,12 @@
 END_UNRELEASED_TEMPLATE
 -->
 
-{#v0-0-0}
-## Unreleased
+{#1-6-0}
+## [1.6.0] - 2025-08-23
 
-[0.0.0]: https://github.com/bazel-contrib/rules_python/releases/tag/0.0.0
+[1.6.0]: https://github.com/bazel-contrib/rules_python/releases/tag/1.6.0
 
-{#v0-0-0-changed}
+{#1-6-0-changed}
 ### Changed
 * (gazelle) update minimum gazelle version to 0.36.0 - may cause BUILD file changes
 * (gazelle) update minimum rules_go version to 0.55.1
@@ -84,7 +84,7 @@
 
 [20250808]: https://github.com/astral-sh/python-build-standalone/releases/tag/20250808
 
-{#v0-0-0-fixed}
+{#1-6-0-fixed}
 ### Fixed
 * (toolchains) `local_runtime_repo` now respects changes to the `DEVELOPER_DIR` and `XCODE_VERSION`
   repo env vars, fixing stale cache issues on macOS with system (i.e. Xcode-supplied) Python
@@ -131,7 +131,7 @@
   ([#2797](https://github.com/bazel-contrib/rules_python/issues/2797)).
 * (py_wheel) Add directories in deterministic order.
 
-{#v0-0-0-added}
+{#1-6-0-added}
 ### Added
 * (repl) Default stub now has tab completion, where `readline` support is available,
   see ([#3114](https://github.com/bazel-contrib/rules_python/pull/3114)).
@@ -162,7 +162,7 @@
 * (gazelle) New directive `gazelle:python_proto_naming_convention`; controls
   naming of `py_proto_library` rules.
 
-{#v0-0-0-removed}
+{#1-6-0-removed}
 ### Removed
 * Nothing removed.
 

docs/pypi/use.md

diff --git a/docs/pypi/use.md b/docs/pypi/use.md
index a668167..9d0c54c 100644
--- a/docs/pypi/use.md
+++ b/docs/pypi/use.md
@@ -45,7 +45,7 @@
 * `@pypi//numpy:whl` - the {obj}`filegroup` that is the `.whl` file itself, which includes all
   transitive dependencies via the {attr}`filegroup.data` attribute.
 
-:::{versionadded} VERSION_NEXT_FEATURE
+:::{versionadded} 1.6.0
 
 The `:extracted_whl_files` target was added
 :::

gazelle/docs/annotations.md

diff --git a/gazelle/docs/annotations.md b/gazelle/docs/annotations.md
index da6e58f..728027f 100644
--- a/gazelle/docs/annotations.md
+++ b/gazelle/docs/annotations.md
@@ -118,7 +118,7 @@
 
 ## `include_pytest_conftest`
 
-:::{versionadded} VERSION_NEXT_FEATURE
+:::{versionadded} 1.6.0
 {gh-pr}`3080`
 :::
 

python/private/pypi/extension.bzl

diff --git a/python/private/pypi/extension.bzl b/python/private/pypi/extension.bzl
index 331ecf2..03af863 100644
--- a/python/private/pypi/extension.bzl
+++ b/python/private/pypi/extension.bzl
@@ -1314,7 +1314,7 @@
 [environment_markers]: https://packaging.python.org/en/latest/specifications/dependency-specifiers/#environment-markers
 :::
 
-:::{versionadded} VERSION_NEXT_FEATURE
+:::{versionadded} 1.6.0
 :::
 """,
         ),