feat(Settings): Rewrite settings content for decision making
What does this MR do?
The changes aim to improve the usefulness of settings management in GitLab. It includes content on:
- Clarifying setting restrictions
- Providing shortcuts to relevant settings
- Ensuring sensible saving of changes, avoiding new navigation entries
- Maintaining consistency in the URL structure
- Adhering to the knowledge structure
- Minimizing the use of direct links to documentation.
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.
Links
Related Exploration on standardizing patterns used for ... (gitlab-org/gitlab#275969), Define: What is a setting (#1772)
Edited by Austin Regnery