diff --git a/analysis_options.yaml b/analysis_options.yaml
index cdd7ad66fd..dd883acf7e 100644
--- a/analysis_options.yaml
+++ b/analysis_options.yaml
@@ -55,12 +55,12 @@ linter:
     # - avoid_catches_without_on_clauses # we do this commonly
     # - avoid_catching_errors # we do this commonly
     - avoid_classes_with_only_static_members
-    # - avoid_double_and_int_checks # not yet tested
+    # - avoid_double_and_int_checks # only useful when targeting JS runtime
     - avoid_empty_else
     # - avoid_field_initializers_in_const_classes # not yet tested
     - avoid_function_literals_in_foreach_calls
     - avoid_init_to_null
-    # - avoid_js_rounded_ints # not yet tested
+    # - avoid_js_rounded_ints # only useful when targeting JS runtime
     - avoid_null_checks_in_equality_operators
     # - avoid_positional_boolean_parameters # not yet tested
     # - avoid_private_typedef_functions # we prefer having typedef (discussion in https://github.com/flutter/flutter/pull/16356)
@@ -126,7 +126,7 @@ linter:
     # - prefer_function_declarations_over_variables # not yet tested
     - prefer_initializing_formals
     # - prefer_interpolation_to_compose_strings # not yet tested
-    # - prefer_iterable_whereType # not yet tested
+    # - prefer_iterable_whereType # https://github.com/dart-lang/sdk/issues/32463
     - prefer_is_empty
     - prefer_is_not_empty
     - prefer_single_quotes
diff --git a/analysis_options_repo.yaml b/analysis_options_repo.yaml
index b9f61fdc8e..b0bb0f76d9 100644
--- a/analysis_options_repo.yaml
+++ b/analysis_options_repo.yaml
@@ -52,12 +52,12 @@ linter:
     # - avoid_catches_without_on_clauses # we do this commonly
     # - avoid_catching_errors # we do this commonly
     - avoid_classes_with_only_static_members
-    # - avoid_double_and_int_checks # not yet tested
+    # - avoid_double_and_int_checks # only useful when targeting JS runtime
     - avoid_empty_else
     # - avoid_field_initializers_in_const_classes # not yet tested
     - avoid_function_literals_in_foreach_calls
     - avoid_init_to_null
-    # - avoid_js_rounded_ints # not yet tested
+    # - avoid_js_rounded_ints # only useful when targeting JS runtime
     - avoid_null_checks_in_equality_operators
     # - avoid_positional_boolean_parameters # not yet tested
     # - avoid_private_typedef_functions # we prefer having typedef (discussion in https://github.com/flutter/flutter/pull/16356)
@@ -123,7 +123,7 @@ linter:
     # - prefer_function_declarations_over_variables # not yet tested
     - prefer_initializing_formals
     # - prefer_interpolation_to_compose_strings # not yet tested
-    # - prefer_iterable_whereType # not yet tested
+    # - prefer_iterable_whereType # https://github.com/dart-lang/sdk/issues/32463
     - prefer_is_empty
     - prefer_is_not_empty
     - prefer_single_quotes