add versionadded, small doc updates

Author: rickeylev

CHANGELOG.md

@@ -78,8 +78,8 @@ Unreleased changes template.
 * (sphinxdocs) Do not crash when `tag_class` does not have a populated `doc` value.
   Fixes ([#2579](https://github.com/bazelbuild/rules_python/issues/2579)).
 * (binaries/tests) Fix packaging when using `--bootstrap_impl=script`: set
-  {obj}`--venvs_use_declare_symlink=no` to have it avoid creating symlinks at
-  build time.
+  {obj}`--venvs_use_declare_symlink=no` to have it not create symlinks at
+  build time (they will be created at runtime instead).
   Fixes ([#2489](https://github.com/bazelbuild/rules_python/issues/2489)
 
 {#v0-0-0-added}

docs/api/rules_python/python/config_settings/index.md

@@ -212,27 +212,6 @@ Values:
 :::
 ::::
 
-::::{bzl:flag} venvs_use_declare_symlink
-
-Determines if relative symlinks are created using `declare_symlink()` at build
-time.
-
-This is only intended to work around
-[#2489](https://github.com/bazelbuild/rules_python/issues/2489), where some
-packaging rules don't support `declare_symlink()` artifacts.
-
-Values:
-* `yes`: Use `declare_symlink()` and create relative symlinks at build time.
-* `no`: Do not use `declare_symlink()`. Instead, the venv will be created at
-  runtime.
-
-:::{seealso}
-{envvar}`RULES_PYTHON_EXTRACT_ROOT` for customizing where the runtime venv
-is created.
-:::
-
-:::{versionadded} VERSION_NEXT_PATCH
-:::
 
 ::::{bzl:flag} bootstrap_impl
 Determine how programs implement their startup process.
@@ -280,3 +259,26 @@ Values:
 :::
 
 ::::
+
+::::{bzl:flag} venvs_use_declare_symlink
+
+Determines if relative symlinks are created using `declare_symlink()` at build
+time.
+
+This is only intended to work around
+[#2489](https://github.com/bazelbuild/rules_python/issues/2489), where some
+packaging rules don't support `declare_symlink()` artifacts.
+
+Values:
+* `yes`: Use `declare_symlink()` and create relative symlinks at build time.
+* `no`: Do not use `declare_symlink()`. Instead, the venv will be created at
+  runtime.
+
+:::{seealso}
+{envvar}`RULES_PYTHON_EXTRACT_ROOT` for customizing where the runtime venv
+is created.
+:::
+
+:::{versionadded} VERSION_NEXT_PATCH
+:::
+::::

docs/environment-variables.md

@@ -24,7 +24,7 @@ When `1`, the rules_python Starlark implementation of the core rules is used
 instead of the Bazel-builtin rules. Note this requires Bazel 7+.
 :::
 
-:::{envvar} RULES_PYTHON_EXTRACT_ROOT
+::::{envvar} RULES_PYTHON_EXTRACT_ROOT
 
 Directory to use as the root for creating files necessary for bootstrapping so
 that a binary can run.
@@ -43,7 +43,10 @@ being cleaned up by the OS.
 
 If not set, then a temporary directory will be created and deleted upon program
 exit.
+
+:::{versionadded} VERSION_NEXT_PATCH
 :::
+::::
 
 :::{envvar} RULES_PYTHON_GAZELLE_VERBOSE