The plugin should explain when and how to use which control

[daniel-beck]

Describe your use-case which is not covered by existing documentation.

The plugin should explain:

• when to use a checkbox, and when to use a toggle button (are they dissimilar enough to warrant two pages?).
• when to use a normal, primary, destructive, or transparent button, or when it is appropriate to add an icon.
• when a notification should be programmatically hidden rather than wait for the user to dismiss it.
• what constitutes an "important action" for app bars.
• when one should use the combo box, and when one should use a text box with suggestions (this one pre-dates recent UI work, but still).
• what spacing class is appropriate in which context.

There's probably more, but these are the ones I noticed in a quick review of the demo pages.

Reference any relevant documentation, other materials or issues/pull requests that can be used for inspiration.

No response