These changes are not being proposed as completed button usage documentation, just a slight improvement over what was already there.
The content of the page has simply been restructured and given slightly more detail. No new ideas are being presented, but existing documentation (specifically: CSS component docs and Figma Primer Web) was referenced to add useful details that may have been missing before.
What to focus on
- Is the document at least as accurate as it was before these changes?
- Is the content easier to navigate and understand than it was before?
Drawbacks
The document has more sections. I think this makes it easier to navigate, but that might just be my personal preference.
Demo
Before
See live Button usage docs