[Docs] Clarify that Flex does not wrap (#113404)
diff --git a/packages/flutter/lib/src/widgets/basic.dart b/packages/flutter/lib/src/widgets/basic.dart
index 8c86b27..d82651e 100644
--- a/packages/flutter/lib/src/widgets/basic.dart
+++ b/packages/flutter/lib/src/widgets/basic.dart
@@ -4384,6 +4384,10 @@
/// you have some widgets and want them to be able to scroll if there is
/// insufficient room, consider using a [ListView].
///
+/// The [Flex] widget does not allow its children to wrap across multiple
+/// horizontal or vertical runs. For a widget that allows its children to wrap,
+/// consider using the [Wrap] widget instead of [Flex].
+///
/// If you only have one child, then rather than using [Flex], [Row], or
/// [Column], consider using [Align] or [Center] to position the child.
///
@@ -4433,6 +4437,7 @@
/// * [Flexible], to indicate children that should share the remaining room.
/// * [Spacer], a widget that takes up space proportional to its flex value.
/// that may be sized smaller (leaving some remaining room unused).
+/// * [Wrap], for a widget that allows its children to wrap over multiple _runs_.
/// * The [catalog of layout widgets](https://flutter.dev/widgets/layout/).
class Flex extends MultiChildRenderObjectWidget {
/// Creates a flex layout.
