Docs: Definition of done (#4273)

* Docs: Definition of done

* component-checklist

* Completed checklists

* Update index.mdx

* Update index.mdx

* incorporated-feedback-from-meeting

* Delete draft

* fix(format): update

* feat: add custom table styles

* fix: filename

* Add: content edits

* Apply suggestions from design review

Co-authored-by: Alina Jacob <[email protected]>

* chore: yarn format

* Update index.mdx

Jeannie's small type updates

* typos.mdx

* Update from Alina's review

* run prettier

---------

Co-authored-by: ariellalgilmore <[email protected]>
Co-authored-by: Alison Joseph <[email protected]>
Co-authored-by: Alina Jacob <[email protected]>
Co-authored-by: jeanservaas <[email protected]>
Co-authored-by: Kritvi <[email protected]>

src/data/nav-items.yaml

@@ -42,11 +42,9 @@
 - title: Contributing
   pages:
     - title: Get started
-      path: /contributing/get-started/
-    - title: Code
-      path: /contributing/code/
-    - title: Design
-      path: /contributing/design/
+      path: /contributing/get-started/overview
+    - title: Component checklist
+      path: /contributing/component-checklist/
     - title: Documentation
       path: /contributing/documentation/
 - title: Migrating

src/pages/contributing/code.mdx → src/pages/contributing/get-started/code.mdx

@@ -1,8 +1,9 @@
 ---
-title: Code
+title: Getting started
 description:
   Code contributions can include anything from squashing bugs to adding feature
   requests. Check out the instructions below to contribute code effectively.
+tabs: ['Overview', 'Code', 'Design']
 ---
 
 export const Title = () => <span>Contribute code</span>;

src/pages/contributing/design.mdx → src/pages/contributing/get-started/design.mdx

@@ -1,9 +1,10 @@
 ---
-title: Design
+title: Getting started
 description:
   Design contributions can involve anything from creating design specs for
   feature requests to maintaining Figma libraries. Below you'll find tips and
   best practices to get started.
+tabs: ['Overview', 'Code', 'Design']
 ---
 
 export const Title = () => <span>Contribute design</span>;

src/pages/contributing/get-started.mdx → src/pages/contributing/get-started/overview.mdx

@@ -1,9 +1,10 @@
 ---
-title: Get started
+title: Getting started
 description:
-  The Carbon Design System is made possible through a vibrant community of
-  designers and developers. Anyone can contribute code, design, documentation,
-  and ideas. Here's how you can contribute, too!
+  Design contributions can involve anything from creating design specs for
+  feature requests to maintaining Figma libraries. Below you'll find tips and
+  best practices to get started.
+tabs: ['Overview', 'Code', 'Design']
 ---
 
 <PageDescription>
@@ -192,6 +193,15 @@ solutions and then creating a design spec for developers.
 [Here are issues](https://github.com/carbon-design-system/carbon/issues?q=is%3Aopen+is%3Aissue+label%3A%22needs%3A+community+contribution%22+)
 in our enhancement backlog that need design or development work.
 
+### New components
+
+New components are a large multidiscipline contribution and must be contributed
+in phases to insure quality and business value. To propose a net new component,
+follow the [phased contribution process](/contributing/contribution-process) and
+complete all requirements in the
+[component checklist](contributing/component-checklist). All requirement
+categories must be completed before a component can be considered done.
+
 ### Design kits
 
 This work is all about creating and updating reusable components in Figma.
@@ -226,8 +236,14 @@ on the IBM Design Language site.
 
 ## The process
 
-Whether you're contributing code, designs, or documentation, there's a process
-to follow. Here's what it looks like:
+Whether you’re contributing code, designs, or documentation, there’s a process
+to follow.  For larger contributions like new components or patterns a more
+rigorous process must be followed to insure production level quality and
+business value. We have laid out the phases and criteria on the next page in
+[contribution process](contributing/contribution-process).
+
+For smaller contributions like small additions, enhancements, or bug fixes
+follow the process below.
 
 ### 1. Find a project to work on
 
@@ -262,7 +278,7 @@ Guild, Data Viz Guild, or office hours. In these sessions, it is common to share
 work in progress and ask lots of questions. As you make progress, update your
 GitHub issue.
 
-### 3. Review and publish
+### 3. Submit for review
 
 #### Code deliverables
 

src/styles/_component-checklist.scss

@@ -0,0 +1,16 @@
+//---------------------------------------
+// Contributing / Component checklist
+//---------------------------------------
+
+// custom table styles
+// align to grid
+.table--component-checklist .page-table {
+  th:first-child {
+    // 2 columns
+    width: 15.4%;
+  }
+  th:nth-child(2) {
+    // 5 columns
+    width: 43%;
+  }
+}

src/styles/index.scss

@@ -8,6 +8,7 @@
 @import 'structured-list';
 @import 'plex-serif';
 @import 'meetups';
+@import 'component-checklist';
 @import 'overrides';
 @import 'src/components/ColorBlock/color-block.scss';
 @import 'src/components/ColorGrid/color-grid.scss';