Clarify Android heading docs for SemanticsProperties.header

mayanksharma9 · mayanksharma9 · commit 9399c6380f2d · 2026-03-16T16:09:54.000-07:00
diff --git a/packages/flutter/lib/src/semantics/semantics.dart b/packages/flutter/lib/src/semantics/semantics.dart
@@ -1801,10 +1801,10 @@ class SemanticsProperties extends DiagnosticableTree {
   /// application might define headers A, B, C, etc. to divide the list of
   /// alphabetically sorted contacts into sections.
   ///
-  /// Support for this semantic varies by platform. Android accessibility
-  /// exposes headings rather than a separate header concept, so `header` alone
-  /// is not sufficient there. To mark content as a heading on Android, also set
-  /// [headingLevel].
+  /// Support for this semantic varies by platform. On Android, this property
+  /// alone is not sufficient. To mark content as a heading for accessibility
+  /// services, also set [headingLevel]. This is because Android accessibility
+  /// APIs expose headings, but not a separate header concept.
   final bool? header;
 
   /// If non-null, indicates that this subtree represents a text field.
