Move Product Principles to Pajamas docs
Current state
https://gitlab.com/gitlab-org/gitlab-ce/issues/35649 discussed the banners we show throughout GitLab and their usage rules. One of the outcomes was adding these guidelines to the Product handbook page (specifically, in the Product Core Values section): https://about.gitlab.com/handbook/product/#banners
As a parallel, the Pajamas docs detail the usage of many other components (where “banners” would fit as well).
I believe the Product Principles section in the Product handbook page and the Pajamas docs share the same intentions and possibly the same content. This goes to show that Product, UX, and Frontend have a lot in common and share responsibilities in defining the user experience of the product. However, the guidelines produced by these teams should be followed not only by GitLabbers but everyone who contributes.
I understand the documentation target audiences as:
- The Handbook for GitLabbers
- The Pajamas docs, Development docs and CONTRIBUTING.md for every contributor
- PROCESS.md for Core team members and GitLabbers
Proposal
For these reasons, it makes sense to move the Product Principles section of the Product handbook page to Pajamas docs.
Dependencies
- https://gitlab.com/gitlab-org/design.gitlab.com/merge_requests/143: to get Markdown support in the Pajamas docs — this will make the transition smoother and allow everyone to keep contributing to these values as they have until today (using MD instead of HTML).