feat(Tabs): clarify when to use button groups instead of tabs
What does this MR do?
Tabs have been commonly used in a variety of pages to off a mechanism to switch between content. However, applying tabs to all scenarios is not the best choice.
Here are a few examples of places where tabs are best served due to differentiated content
| Merge requests | Pipelines |
|---|---|
![]() |
![]() |
Here are a few examples of places where tabs could be replaced by a button group instead.
| Tab Group | Button Group |
|---|---|
![]() |
![]() |
![]() |
![]() |
This merge request updates documentation for button and tab components. For buttons, it clarifies the use using GlButtonGroup instead of the deprecated segmented control, and updates information about pagination. For tabs, it adds guidance on when to use button groups instead of tabs for toggling between a small set of related options.
Does this MR meet the acceptance criteria?
-
The MR title and commit messages meet the Pajamas commit conventions. -
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 Pajamas voice and tone guidelines, falling back on the GitLab Documentation Style Guide when needed. -
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
Edited by Austin Regnery





