feat(principles): Extend existing principles
What does this MR do?
This MR is an iterative update to address gitlab-org/gitlab-design#2551 (closed).
Why make this change? Though we have robust process principles, the principles that help guide our day-to-day experience decisions feel like they could be extended, in part to reflect some of the latest discussions around principles.
In an effort to further extend and document these principles I've suggested:
- Combining the existing "Productive" and "Minimal" principles.
- Extending the existing "Human" principle to clarify that empathy with users means supporting their larger goals/outcomes, which further encourages designers to have a "whole product" or "whole workflow" mentality. This is following the "be goal-driven over task-driven" AI product principle.
- Introducing the "be transparent over opaque" principle from the AI product principle discussions, as it seems applicable to the product more generally, too.
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 Amelia Bauerly