reword comments on the future

Author: aignas

python/private/pypi/extension.bzl

@@ -505,10 +505,12 @@ You cannot use both the additive_build_content and additive_build_content_file a
                 platform = tag.platform,
                 override = mod.is_root,
                 # TODO @aignas 2025-05-19: add more attr groups:
-                # * for AUTH
-                # * for index config
-                # * for whl selection
-                # * for custom platform definition
+                # * for AUTH - the default `netrc` usage could be configured through a common
+                # attribute.
+                # * for index/downloader config. This includes all of those attributes for
+                # overrides, etc. Index overrides per platform could be also used here.
+                # * for whl selection - selecting preferences of which `platform_tag`s we should use
+                # for what. We could also model the `cp313t` freethreaded as separate platforms.
             )
 
     config = _create_config(defaults)

python/private/pypi/requirements_files_by_platform.bzl

@@ -113,7 +113,8 @@ def requirements_files_by_platform(
             be joined with args fined in files.
         python_version: str or None. This is needed when the get_index_urls is
             specified. It should be of the form "3.x.x",
-        platforms: TODO
+        platforms: {type}`list[str]` the list of human-friendly platform labels that should
+            be used for the evaluation.
         logger: repo_utils.logger or None, a simple struct to log diagnostic messages.
         fail_fn (Callable[[str], None]): A failure function used in testing failure cases.
 
@@ -137,7 +138,7 @@ def requirements_files_by_platform(
 
     platforms_from_args = _platforms_from_args(extra_pip_args)
     if logger:
-        logger.debug(lambda: "Platforms from pip args: {}".format(platforms))
+        logger.debug(lambda: "Platforms from pip args: {}".format(platforms_from_args))
 
     default_platforms = [_platform(p, python_version) for p in platforms]