Apply suggestions from code review

Author: rickeylev

CHANGELOG.md

@@ -76,7 +76,7 @@ END_UNRELEASED_TEMPLATE
   for a target). If they don't match, dependencies won't be importable. (Such a
   misconfiguration was unlikely to work to begin with; this is called out as an
   FYI).
-* (rules) {obj}`--bootstrap_impl=script` is the default for non-Windows for bazel 8 and above.
+* (rules) {obj}`--bootstrap_impl=script` is the default for non-Windows for Bazel 8 and above.
 
 {#v0-0-0-fixed}
 ### Fixed

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

@@ -245,9 +245,11 @@ Values:
 ::::{bzl:flag} bootstrap_impl
 Determine how programs implement their startup process.
 
-The default for this depends on the platform:
+The default for this depends on the platform and environment:
 * Windows: `system_python` (**always** used)
-* Other: `script`
+* Non-Windows with Bazel 8 or higher: `script`
+* Other: `system_python`
+
 
 Values:
 * `system_python`: Use a bootstrap that requires a system Python available
@@ -274,8 +276,7 @@ instead.
 :::
 
 :::{versionchanged} VERSION_NEXT_FEATURE
-* The default for non-Windows changed from `system_python` to `script`.
-* On Windows, the value is forced to `system_python`.
+* The default changed from `system_python` to `script` for non-Windows with Bazel 8 or higher.
 :::
 
 ::::

python/private/util.bzl

@@ -99,7 +99,7 @@ def define_bazel_6_provider(doc, fields, **kwargs):
         return provider("Stub, not used", fields = []), None
     return provider(doc = doc, fields = fields, **kwargs)
 
-# Only bazel 8 can distinguish symlinks within the file depsets.
+# `config.none` was introduced in Bazel 8
 IS_BAZEL_8_OR_HIGHER = hasattr(config, "none")
 
 IS_BAZEL_7_4_OR_HIGHER = hasattr(native, "legacy_globals")