☂️ Umbrella issue for Material2 API doc updates

### Is there an existing issue for this?

- [X] I have searched the [existing issues](https://github.com/flutter/flutter/issues)
- [X] I have read the [guide to filing a bug](https://flutter.dev/docs/resources/bug-reports)

### Use case

As we prepare to make Material 3 the default, we should make it clear that while Material 2 widgets will continue to exist, some have Material 3 counterparts that may be more useful and better match Material 3 app styles. 


### Proposal

There are a few Material 2 widgets whose API docs need to be updated:
| M2 widget | M3 widget | Tracking issue / PR | 
| --- | ----------- |  ----------- |
| `ToggleButtons` | `SegmentedButtons` | <ul><li>[x] https://github.com/flutter/flutter/pull/127021</li></ul> |
| `BottomNavigationBar` | `NavigationBar` | <ul><li>[x] https://github.com/flutter/flutter/issues/127213</li></ul> |
| `Drawer` | `NavigationDrawer` | <ul><li>[x] https://github.com/flutter/flutter/issues/127214</li></ul> |
| `DropdownButton` | `DropDownMenu` |  <ul><li>[x] https://github.com/flutter/flutter/issues/127215</li></ul> |
| `PopupMenuButton` | `MenuAnchor` |  <ul><li>[x] https://github.com/flutter/flutter/issues/127215</li></ul>|
|`MaterialColor`| `ColorScheme`| <ul><li>[x] https://github.com/flutter/flutter/issues/127228 |
|`ButtonBar` | `OverflowBar ` | <ul><li>[x] https://github.com/flutter/flutter/issues/128430</li></ul> |
|`ActionChip` | Showcase suggest and assist |  <ul><li>[x] https://github.com/flutter/flutter/issues/128028</li></ul> |
|`ThemeData` | List out the properties that should be used for Material3 |  <ul><li>[x] https://github.com/flutter/flutter/issues/130949</li></ul> |



M2 widget	M3 widget	Tracking issue / PR
`ToggleButtons`	`SegmentedButtons`	Updated the `ToggleButtons` API doc to link to `SegmentedButton` #127021
`BottomNavigationBar`	`NavigationBar`	Update `BottomNavigationBar` API docs with details on migrating to `NavigationBar` #127213
`Drawer`	`NavigationDrawer`	Update API docs for `Drawer` to help developers migrate to `NavigationDrawer` #127214
`DropdownButton`	`DropDownMenu`	Update API docs to help developers move to Material 3 style menus #127215
`PopupMenuButton`	`MenuAnchor`	Update API docs to help developers move to Material 3 style menus #127215
`MaterialColor`	`ColorScheme`	Update MaterialColor API docs to migrate to ColorScheme for Material3 apps #127228
`ButtonBar`	`OverflowBar`	Update ButtonBar API docs to show how to migrate to OverflowBar #128430
`ActionChip`	Showcase suggest and assist	Update `ActionChip` documentation to showcase assist and suggestion chip from M3 specs #128028
`ThemeData`	List out the properties that should be used for Material3	Tell developers how to migrate their ThemeData & textTheme widgets over to Material3 #130949

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

☂️ Umbrella issue for Material2 API doc updates #127216

Is there an existing issue for this?

Use case

Proposal

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

☂️ Umbrella issue for Material2 API doc updates #127216

Description

Is there an existing issue for this?

Use case

Proposal

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions