From 58577b2ac4b6dd71568b81e85f7aa1ae70f3f25b Mon Sep 17 00:00:00 2001
From: sarahgm <38324334+sarahgm@users.noreply.github.com>
Date: Thu, 27 Jun 2024 10:03:58 +0200
Subject: [PATCH 1/9] chore: fix schedule for renovate (#3965)
---
.github/renovate.json | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/.github/renovate.json b/.github/renovate.json
index 52dcfc2280..2a3313fc6e 100644
--- a/.github/renovate.json
+++ b/.github/renovate.json
@@ -4,7 +4,7 @@
":semanticCommitTypeAll(chore)",
":rebaseStalePrs"
],
- "schedule": ["earlyMondays"],
+ "schedule": ["before 4am on Monday"],
"packageRules": [
{
"matchDatasources": ["npm"],
From 9a7f349a17ae9ab2726d1578bfdf5a64eb0481c9 Mon Sep 17 00:00:00 2001
From: sarahgm <38324334+sarahgm@users.noreply.github.com>
Date: Thu, 27 Jun 2024 10:04:54 +0200
Subject: [PATCH 2/9] [DST-446]docs: adding governance process page (#3944)
---
.changeset/honest-kids-sit.md | 5 +
.../introduction/governance-process.mdx | 198 ++++++++++++++++++
docs/public/governance-phase1.png | Bin 0 -> 317356 bytes
docs/public/governance-phase2-1.png | Bin 0 -> 139447 bytes
docs/public/governance-phase2-2.png | Bin 0 -> 116460 bytes
docs/public/governance-phase2-3.png | Bin 0 -> 156819 bytes
docs/public/governance-phase2-4.png | Bin 0 -> 295115 bytes
docs/public/governance-phase3a.png | Bin 0 -> 402242 bytes
docs/public/governance-phase3b.png | Bin 0 -> 414515 bytes
9 files changed, 203 insertions(+)
create mode 100644 .changeset/honest-kids-sit.md
create mode 100644 docs/content/introduction/governance-process.mdx
create mode 100644 docs/public/governance-phase1.png
create mode 100644 docs/public/governance-phase2-1.png
create mode 100644 docs/public/governance-phase2-2.png
create mode 100644 docs/public/governance-phase2-3.png
create mode 100644 docs/public/governance-phase2-4.png
create mode 100644 docs/public/governance-phase3a.png
create mode 100644 docs/public/governance-phase3b.png
diff --git a/.changeset/honest-kids-sit.md b/.changeset/honest-kids-sit.md
new file mode 100644
index 0000000000..755e3c5354
--- /dev/null
+++ b/.changeset/honest-kids-sit.md
@@ -0,0 +1,5 @@
+---
+"@marigold/docs": patch
+---
+
+[DST-446]docs: adding governance process page
diff --git a/docs/content/introduction/governance-process.mdx b/docs/content/introduction/governance-process.mdx
new file mode 100644
index 0000000000..0fcd7304e7
--- /dev/null
+++ b/docs/content/introduction/governance-process.mdx
@@ -0,0 +1,198 @@
+---
+title: Governance process
+caption: Making changes and additions to Marigold.
+order: 6
+badge: new
+---
+
+Product teams are primarily focused on getting the job done. In their quest to achieve this, they sometimes need to take on design debt—improvising styles, crafting unique components, or even bypassing the design system entirely. To help teams avoid unnecessary debt, we've established a governance process that guides both the product teams and us on managing changes and additions within Marigold.
+
+This process ensures that any modifications to the design system are carefully evaluated to maintain consistency, stability, and user-friendliness. We prioritize updates that meet specific user needs, adhere to industry standards, and offer high reusability. Guided by our [Governance values and principles](/introduction/governance-values), this approach helps uphold the quality and integrity of our design system.
+
+If you ever asked yourself what we do with your feature requests or what you should do if we declined your request, you've come to the right place.
+
+We have created a flowchart, divided into 3 phases, that illustrates how incoming feature requests are handled.
+
+
+ Note
+
+ ug fixes aren't subject to the same rigorous evaluation process and are
+ handled differently. To read more about how to report bugs go
+ [here](/introduction//get-in-touch/#report-bugs).
+
+
+
+
+
+
+
+## Phase 1: Product team discovers a problem
+
+What should you do if, while using the design system, you discover it's unable to provide something you need?
+
+
+
+ **Step 1:** The process begins when the product team discovers a problem with
+ Marigold, which could be, for example, a missing, broken, or
+ non-user-friendly component.
+
+ **Step 2:** The product team should first try to discover whether the Design System offers an existing alternative to solve the problem.
+
+ - **Yes:** If a viable alternative exists within the design system, the product team should use it.
+
+ - **No:** If there is no viable alternative, the product team should write a [request(internal only)](https://reservix.atlassian.net/servicedesk/customer/portal/77).
+
+ If the product team writes a support ticket, this triggers phase 2.
+
+
+
+
+
+## Phase 2: Design system team evaluates the request
+
+This phase is only relevant if you have written a support ticket. This phase explains what happens to your request and how we evaluate it.
+
+
+
+
+ **Step 1:** If we have received a request through our [support portal (internal only)](https://reservix.atlassian.net/servicedesk/customer/portal/77) we have to check if there is clear evidence of user need.
+
+ - **Yes:** If there is clear evidence of user need, move to step 2.
+
+ - **No:** If there isn't clear evidence, the request is declined, and alternative solutions are offered.
+
+
+
+
+
+
+ **Step 2:** For the next decision we have to check if the requested change will feel familiar to our users, i.e., if it is consistent with broader UX standards.
+
+ - **Yes:** If the requested change will feel familiar to users, move to step 3.
+
+ - **No:** If it won't feel familiar the request is declined and alternative solutions are offered.
+
+
+
+
+
+ **Step 3:** We have to check if the change is likely to be reusable across multiple products.
+
+ - **Yes:** If the change is likely to be reusable across multiple products, we approve the request.
+
+ - **No:** If it isn't likely to be reusable, the request is declined, and alternative solutions are offered.
+
+
+
+
+
+ **Step 4:** The next step is to determine the estimated timeline, including the roadmap and estimated effort.
+
+ **Step 5:** The product team decides if the estimated implementation timeline will meet their needs.
+
+ - **Yes:** If the estimated timeline works for the product team, the product team waits for delivery while the Design System Team proceeds to Phase 3a.
+
+ - **No:** If the estimated timeline does not work, the process goes to Phase 3b.
+
+
+
+
+
+
+## Phase 3a: Design system team fulfills the request
+
+This phase can only be achieved if the estimated time for the request is acceptable for you and your team and you are willing to wait for us to deliver it. In that case, you can follow the process below.
+
+
+
+ **Step 1:** We start designing the request or addition.
+
+ **Step 2:** Does the design fulfill [WCAG 2.1 AA](https://www.w3.org/TR/WCAG21/) requirements:
+
+ - **Yes:** If the result meets [WCAG 2.1 AA](https://www.w3.org/TR/WCAG21/) requirements, proceed to testing.
+
+ - **No:** If it does not meet these requirements, the design decisions must be revisited.
+
+ **Step 3:** Test the design in real-world environments, ideally with real users.
+
+ **Step 4:** We need to check if the solution meets the three key criteria: user need, familiarity, and reusability.
+
+ - **Yes:** If it still meets all three criteria, proceed to the voting stage in step 5.
+
+ - **No:** If it does not meet the criteria, iterate on the design.
+
+ **Step 5:** The Design System Team and major stakeholders (e.g., UX/UI Community of Practice) vote on the solution. Is there agreement?
+
+ - **Yes:** If there is consensus, proceed to documentation.
+
+ - **No:** If there is no consensus, revisit the design and address concerns.
+
+ **Step 6:** We document the approved changes.
+
+ **Step 7:** We merge the changes to the codebase.
+
+ **Step 8:** We communicate the change or addition.
+
+
+
+
+
+## Phase 3b: Product team’s response if request can’t or won’t be fulfilled
+
+What if you cannot wait for us to deliver a request, or we decide it doesn't meet our criteria for becoming part of the design system?
+
+
+
+ **Step 1:** The product team must decide if they are still convinced of the need for their request.
+
+ - **Yes:** If the product team is still convinced of the need for the request, they proceed to step 2.
+
+ - **No:** If the product team is no longer convinced of the need for the request, the process ends, and the product team re-examines their requirements.
+
+ **Step 2:** If the product team is still convinced of the need for the request, they can choose to build their own component or solution, receiving support as needed from the design system team.
+
+ **Step 3:** Throughout the development process, the product team frequently coordinates with the design system team to ensure alignment and adherence to guidelines.
+
+ **Step 4:** The product team ensures that all design tokens and sub-elements used in their solution are sourced from the design system as much as possible to maintain consistency.
+
+ **Step 5:** The product team takes ownership of the custom solution they have developed. They document the solution and maintain it.
+
+ **Step 6:** If, at some point, a viable alternative becomes available, the product team can decide to use it in place of their custom solution.
+
+ - **Yes:** If a viable alternative becomes available in the design system, the product team removes their custom solution and implements the official one.
+
+ - **No:** If there is still no alternative available in the design system the product team continue to maintain their custom solution.
+
+
+
+
+
+
+
+
+ End of process
+
+
+ With end of Phase 3a the request is fulfilled and the process of making changes and additions is done. 🎉
+
+ In Phase 3b, the process concludes either with the product team maintaining the change or awaiting an alternative solution from the Design System Team.
+
+
+
diff --git a/docs/public/governance-phase1.png b/docs/public/governance-phase1.png
new file mode 100644
index 0000000000000000000000000000000000000000..e5b39c8c4d279b1d98dff6b52adee430ffeadbf3
GIT binary patch
literal 317356
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