Update API docs for `Drawer` to help developers migrate to `NavigationDrawer`

### 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

We should add information to the API docs for the M2 widget `Drawer` to help developers migrate to the M3 widget `NavigationDrawer`

### Proposal

N/A