[Docs] Updated Floating action button menus doc to make it more user friendly

PiperOrigin-RevId: 776413842

Author: Material Design Team

docs/components/FloatingActionButtonMenu.md

@@ -7,36 +7,60 @@ iconId: button
 path: /catalog/floating-action-button-menu/
 -->
 
-# Floating action button menus
+# Floating action button (FAB) menu
 
-A [FAB menu](https://m3.material.io/components/fab-menu) opens from a FAB to show
-multiple related actions.
+A
+[floating action button (FAB) menu](https://m3.material.io/components/fab-menu/overview)
+opens from a FAB to show 2–6 related actions floating on screen. There is one
+FAB menu size for all sizes of FABs.
 
-!["A FAB menu on a screen"](assets/fabmenu/fabmenu_hero.png)
+![FAB menu one type.](assets/fabmenu/fabmenu_type.png)
+
+Fab menu is not used with extended FABs and it is available in primary,
+secondary, and tertiary color sets.
+
+![A FAB menu on a screen.](assets/fabmenu/fabmenu_hero.png)
+
+Use the FAB menu to show multiple related actions in a prominent, expressive
+style. It should always appear in the same place as the FAB that opened it.
 
 ## Design & API documentation
 
 *   [Material 3 (M3) spec](https://m3.material.io/components/fab-menu/overview)
-*   [API reference](https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary?hl=en#FloatingActionButtonMenu(kotlin.Boolean,kotlin.Function0,androidx.compose.ui.Modifier,androidx.compose.ui.Alignment.Horizontal,kotlin.Function1))
+*   [API reference](https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary?hl=en#FloatingActionButtonMenu\(kotlin.Boolean,kotlin.Function0,androidx.compose.ui.Modifier,androidx.compose.ui.Alignment.Horizontal,kotlin.Function1\))
 
-## Using FAB menus
+## Anatomy
 
-Use the FAB menu to show multiple related actions in a prominent, expressive
-style.
+![FAB menu anatomy diagram](assets/fabmenu/fabmenu_anatomy.png)
 
-A FAB menu opens from a FAB to show multiple related actions. It should always
-appear in the same place as the FAB that opened it.
+1.  Close button
+2.  Menu item
 
-### Anatomy
+More details on anatomy items in the
+[component guidelines](https://m3.material.io/components/fab-menu/guidelines#eee40b5b-ce91-458e-9005-19db241f074c).
 
-![FAB menu anatomy diagram](assets/fabmenu/fabmenu_anatomy.png)
+## M3 Expressive update
 
-When expanded, a FAB menu has a close button and multiple list items.
+The FAB menu adds more options to the FAB. It should replace the speed dial and
+any usage of stacked small FABs.
+[More on M3 Expressive](https://m3.material.io/blog/building-with-m3-expressive)
 
-1.  Close button
-1.  List item
+<img src="assets/fabmenu/fabmenu_expressive.png" alt="All size FAB menu expressive" width="700"/>
+The FAB menu uses contrasting color and large items to focus attention. It can
+open from any size FAB.
+
+**New component added to catalog:**
+
+*   One menu size that pairs with any FAB
+*   Replaces any usage of stacked small FABs
+
+**Color:**
+
+*   Contrasting close button and item colors
+*   Supports dynamic color
+*   Compatible with any FAB color style
 
-### Usage (via Compose interop)
+## Code implementation (via Compose interop)
 
 The FAB menu component is currently not available as a native **Views**
 component. This doc shows how to use the **Compose** FAB menu component via the
@@ -45,7 +69,7 @@ Views <-> Compose interop.
 Compose API and source code:
 
 *   `FloatingActionButtonMenu`
-    *   [API documentation](https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary?hl=en#FloatingActionButtonMenu(kotlin.Boolean,kotlin.Function0,androidx.compose.ui.Modifier,androidx.compose.ui.Alignment.Horizontal,kotlin.Function1))
+    *   [API documentation](https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary?hl=en#FloatingActionButtonMenu\(kotlin.Boolean,kotlin.Function0,androidx.compose.ui.Modifier,androidx.compose.ui.Alignment.Horizontal,kotlin.Function1\))
     *   [Source code](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/FloatingActionButtonMenu.kt)
     *   [Sample code](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:compose/material3/material3/samples/src/main/java/androidx/compose/material3/samples/FloatingActionButtonMenuSamples.kt)
 
@@ -62,7 +86,7 @@ Finally, add a `ComposeView` to your app by following the
 [Using Compose in Views](https://developer.android.com/develop/ui/compose/migrate/interoperability-apis/compose-in-views)
 interop guide and use the Compose `FloatingActionButtonMenu` within your
 `ComposeView`, by referring to the
-[API documentation](https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary?hl=en#FloatingActionButtonMenu(kotlin.Boolean,kotlin.Function0,androidx.compose.ui.Modifier,androidx.compose.ui.Alignment.Horizontal,kotlin.Function1))
+[API documentation](https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary?hl=en#FloatingActionButtonMenu\(kotlin.Boolean,kotlin.Function0,androidx.compose.ui.Modifier,androidx.compose.ui.Alignment.Horizontal,kotlin.Function1\))
 and
 [sample code](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:compose/material3/material3/samples/src/main/java/androidx/compose/material3/samples/FloatingActionButtonMenuSamples.kt).