Implement new Foundations product structure (MR 1 of 3)
Overview
This is part of a series of merge requests to implement the changes agreed upon in https://gitlab.com/gitlab-com/Product/-/issues/13078+. We're implementing the change across merge requests to reduce the overall size of each change, as they touch many files.
Changes to approve
We'd like to use this MR to approve the full change, to avoid needing to seek approval three times. The MR has been split up due to the size of the changes involved. Many of these changes have already been discussed in https://gitlab.com/gitlab-com/Product/-/issues/13078.
- The
Manage
stage is renamed toFoundations
- The
Foundations
group is split into two:-
Design System
group with categories: Pajamas -
Personal Productivity
group with categories: Navigation, Notifications, Settings
-
- The
Paper cuts
group is added to theFoundations
stage
graph LR;
s_manage["Stage: Foundations"]-->g_foundations["Group: Personal productivity"];
s_manage-->g_design["Group: Design System"];
s_manage-->g_papercuts["Group: UX Paper cuts"];
s_manage-->g_import["Group: Import & Integrate"];
g_foundations-->c_nav["Category: Navigation"];
g_foundations-->c_settings["Category: Settings"];
g_foundations-->c_notifications["Category: Notifications"];
g_design-->c_design["Category: Pajamas"];
g_import-->c_api["Category: API"];
g_import-->c_integrations["Category: Integrations"];
g_import-->c_webhooks["Category: Webhooks"];
g_import-->c_importers["Category: Importers"];
g_import-->c_i18n["Category: Internationalization"];
Individual MR's implementing the above changes:
- Implement the team structure [you are here]
- Rename the
Foundations
group toPersonal productivity
( !134353 (merged)) - Rename the
Manage
stage toFoundations
( !134359)
Approvals
Merge requests with changes to stages and groups and significant changes to categories need to be created, approved, and/or merged by each of the below:
-
Chief Product Officer @david
(post MR link in chief-product-officer once all others have approved) -
PLT Leader relevant to the affected Section(s) @mflouton
-
The Product Director relevant to the affected Section(s) @joshlambert
-
The Engineering Director relevant to the affected Section(s) @m_gill
-
Director of Product Design @vkarnes
Note:_ Chief Product Officer approval should be requested once all other approvals have been completed. To request approval, post the MR link in the #chief-product-officer channel tagging @david
and cc'ing @Gena Schwam
._
The following people need to be on the merge request so they stay informed:
-
Chief Technology Officer @sabrinafarmer
-
Development Leader relevant to the affected Section(s) @timzallmann OR @bmarnane OR @meks
-
VP of Infrastructure & Quality Engineering @meks
-
VP of UX @ampesta
-
Director of Technical Writing @susantacker
-
Engineering Productivity (by @ mentioning @gl-quality/eng-prod
) -
The Product Marketing Manager relevant to the stage group(s)
After Approvals and Merge
-
Create an issue in the gitlab-org/quality/triage-ops
project to update GitLab Bot automation:- for Category change
- for Stage or Group change
- If label migration is required, please follow the self-serve instructions to get started on a one-off label migration MR
-
Open an MR in the gitlab-org/gitlab
project to update any reference of the previous group label to the new one -
Mention the product group Technical Writer to update the documentation metadata -
Share MR in #product
,#development
, and relevant#s_
,#g_
, and#f_
Slack channels
Changes in this MR
Expand
This MR implements the _structure_ agreed upon in https://gitlab.com/gitlab-com/Product/-/issues/13078+ without changing any names. Once merged, the Manage stage will have the following structure:graph LR;
s_manage["Stage: Manage"]-->g_foundations["Group: Foundations"];
s_manage-->g_design["Group: Design System"];
s_manage-->g_papercuts["Group: UX Paper cuts"];
s_manage-->g_import["Group: Import & Integrate"];
g_foundations-->c_nav["Category: Navigation"];
g_foundations-->c_settings["Category: Settings"];
g_foundations-->c_notifications["Category: Notifications"];
g_design-->c_design["Category: Pajamas"];
g_import-->c_api["Category: API"];
g_import-->c_integrations["Category: Integrations"];
g_import-->c_webhooks["Category: Webhooks"];
g_import-->c_importers["Category: Importers"];
g_import-->c_i18n["Category: Internationalization"];
Specific changes:
- Adds a new "Notifications" category that absorbs
notifications
andtodos
features from "Team planning" category - Assigns the new "Notifications" category to the Foundations group
- Breaks the "Nav & Settings" category into two separate categories, each with their own direction page
- Convert the Design System category direction page into the Design System group direction page
- Assign the UX Paper Cuts group into the Manage stage and move the direction page accordingly
- Removes "Docs site" category from Foundations group