Clarify when to use tabs versus button groups
What does this MR do?
Adds behavioral and semantic guidance to distinguish tabs from button groups, and clarifies when to use and not to use each.
This revives the conversation from !4323 (closed), which was closed before merging. Visual alignment work in !5867 is intentionally bringing tabs and button groups closer together visually, so the behavioral and semantic differentiation in the docs is critical to prevent misuse.
Does this MR meet the acceptance criteria?
- The “What does this MR do?” section in the MR description is filled out, explaining the reasons for and scope of the proposed changes, per “Say why not just what”.
- For example, if the MR is focused on usage guidelines, addressing accessibility challenges could be added in a separate MR.
- Relevant label(s) are applied to the MR.
- The MR is added to a milestone.
- If creating a new component page from scratch, it follows the page template structure.
- Content follows the GitLab Documentation Style Guide when appropriate.
- Related pages are cross-linked, where helpful. Component pages have related components and patterns defined in their Markdown front matter.
- If embedding a Figma file, it follows the Figma embed guide.
- Review requested from any GitLab designer or directly from a maintainer or trainee maintainer.
- Maintainer review follows the Pajamas UX maintainer review checklist.
Links
- Revives !4323 (closed)
- Relates to #770 (closed)
- Relates to !5867