document the intention

Author: aignas

CHANGELOG.md

@@ -79,10 +79,12 @@ END_UNRELEASED_TEMPLATE
   length errors due to too long environment variables.
 * (bootstrap) {obj}`--bootstrap_impl=script` now supports the `-S` interpreter
   setting.
-* (pypi) We now by default select the highest closest match wheel version if the user is
-  specifying a particular version via the `whl_platform_tags` or if any version is matched via
-  the `*` token, then we select the lowest available version.
-  Fixes [#3250](https://github.com/bazel-contrib/rules_python/issues/3250).
+* (pypi) We now use the MVC algorithm to select the right wheel when there are multiple wheels for
+  the target platform (e.g. `musllinux_1_1_x86_64` and `musllinux_1_2_x86_64`). If the user
+  wants to set the minimum version for the selection algorithm, use the
+  {attr}`pip.defaults.whl_platform_tags` attribute to configure that. If `musllinux_*_x86_64` is
+  specified, we will chose the lowest available wheel version.  Fixes
+  [#3250](https://github.com/bazel-contrib/rules_python/issues/3250).
 
 {#v0-0-0-added}
 ### Added

python/private/pypi/extension.bzl

@@ -492,11 +492,12 @@ preference.
 Will always  include `"any"` even if it is not specified.
 
 The items in this list can contain a single `*` character that is equivalent to matching the
-latest available version component in the platform_tag. Note, if the wheel platform tag does not
-have a version component, e.g. `linux_x86_64` or `win_amd64`, then `*` will act as a regular
-character.
+lowest available version component in the platform_tag. Note, if the wheel platform tag does not
+have a version component, e.g. `linux_x86_64` or `win_amd64`, then `*` will act as a lower bound
+for the platform version, i.e. `musllinux_1_2_x86_64` means select a wheel that is built for
+`muslc` 1.2 or greater, i.e. prefer `musllinux_1_2_x86_64` over `musllinux_1_3_x86_64` over `musllinux_1_4_x86_64` and so on, but exclude `musllinux_1_1_x86_64` and lower.
 
-We will always select the highest available `platform_tag` version that is compatible with the
+We will always select the lowest available `platform_tag` version that is compatible with the
 target platform.
 
 :::{note}