[material-ui][docs] Revise component demo pages for style, grammar, content, and formatting consistency

[samuelsycamore]

The problem

The Material UI docs have been written by thousands of people over many years. That's really cool, but there's a very conspicuous lack of an editor's touch. Page structure/formatting is inconsistent, grammar often leaves much to be desired, and there are no style rules applied across the board.

As with #32072 and #33998, I intend to audit and revise each existing page individually to apply our company style guide and best practices for writing documentation.

Scope

This issue is only intended to cover the Component pages in the Material UI docs. Most of the Getting started docs have already been revised over the last year. I'll open separate issues in the future for other sections (How To Guides, Customization, etc.) to keep the scope from being too massive here.

The primary goal is consistency. I'm less concerned with adding new content except where I find major gaps that need to be covered.

I intend to review each page individually. Most pages will get their own PR, but some may be grouped together if the edits are minimal. I'll edit as needed for grammar, style, page formatting, content clarity, and completeness.

This is a very, very big project, so I expect it to be ongoing for awhile. This issue is where we can keep track of the progress.

Pages

• INPUTS
  • Autocomplete
  • Button - [material-ui][docs] Revise the Button page #40446
  • Button Group
  • Checkbox
  • Floating Action Button
  • Radio Group
  • Rating
  • Select
  • Slider
  • Switch
  • Text Field - [material-ui][docs] Revise the Text Field demo page #40560
  • Transfer List
  • Toggle Button
• DATA DISPLAY
  • Avatar
  • Badge
  • Chip
  • Divider [material-ui][docs] Revise the Divider page #40356
  • Icons
  • Material Icons - [material-ui][docs] Add more content to the Material Icons page #40445
  • List
  • Table
  • Tooltip
  • Typography
• FEEDBACK
  • Alert - [material-ui][docs] Revise the Alert demo page #34892
  • Backdrop
  • Dialog
  • Progress
  • Skeleton
  • Snackbar [material-ui][docs] Revise the Snackbar page #39298
• SURFACES
  • Accordion [material-ui][docs] Revise the Accordion page #40284
  • App Bar
  • Card
  • Paper [docs][material-ui] Revise the Paper component docs #38841
• NAVIGATION
  • Bottom Navigation
  • Breadcrumbs
  • Drawer
  • Link
  • Menu
  • Pagination
  • Speed Dial
  • Stepper
  • Tabs
• LAYOUT
  • Box - [core][docs] Restore and revise the Box docs #40622
  • Container - [core][docs] Revise the Container docs #41074
  • Grid
  • Grid v2
  • Stack
  • Image List
  • Hidden
• UTILS
  • Click-Away Listener
  • CSS Baseline
  • Modal
  • No SSR
  • Popover
  • Popper
  • Portal
  • Textarea Autosize
  • Transitions
  • useMediaQuery
• LAB
  • About the lab 🧪
  • Masonry
  • Timeline

[github-actions]

This issue has been closed. If you have a similar problem but not exactly the same, please open a new issue.
Now, if you have additional information related to this issue or things that could help future readers, feel free to leave a comment.