gitlab-org--gitlab-foss/doc/development/ux_guide/principles.md

# Principles

These are the guiding principles that we should strive for to establish a solid foundation for the GitLab experience.

## Professional and productive
GitLab is a tool to support what people do, day in, day out. We need to respect the importance of their work, and avoid gimicky details.

## Minimal and efficient
While work can get complicated, GitLab is about bringing a sharp focus, helping our customers know what matters now.

## Immediately recognizable
When you look at any screen, you should know immediately that it is GitLab. Our personality is strong and consistent across product and marketing experiences.

## Human and quirky
We need to build empathy with our users, understanding their state of mind, and connect with them at a human level. Quirkiness is part of our DNA, and we should embrace it in the right moments and contexts.

> TODO: Ensure these principles align well with the goals of the Marketing team
[ci skip] Establish basic structure for ux_guide README.md Block out pages needed for ux_guide Add resources stub to ux_guide home Fill out principles and basics Add TOC to basics Move all of UI guide to new UX guide structure Add first level structure on ux-guide pages Add more details to buttons Add button images. Update link on development Renamed surfaces to templates. Add tooltip details Update typography and icons on Basics page Add images for color. First draft of voice and tone Delete findings page Refine pages. Fill out Surfaces pages Clean up layout on basics, surfaces, features. Add anchorlinks and counts to components Fill out components page Add item title and system info block Fill out Features page Switch tooltip placement image 2016-10-21 21:25:09 +00:00			`# Principles`

			`These are the guiding principles that we should strive for to establish a solid foundation for the GitLab experience.`

			`## Professional and productive`
			`GitLab is a tool to support what people do, day in, day out. We need to respect the importance of their work, and avoid gimicky details.`

			`## Minimal and efficient`
			`While work can get complicated, GitLab is about bringing a sharp focus, helping our customers know what matters now.`

			`## Immediately recognizable`
			`When you look at any screen, you should know immediately that it is GitLab. Our personality is strong and consistent across product and marketing experiences.`

			`## Human and quirky`
			`We need to build empathy with our users, understanding their state of mind, and connect with them at a human level. Quirkiness is part of our DNA, and we should embrace it in the right moments and contexts.`

Remove <br> and replace GFM blockquote with the Markdown general [ci skip] 2016-11-11 17:20:56 +00:00			`> TODO: Ensure these principles align well with the goals of the Marketing team`