WIP - IA updates

conf.d/rewrite.conf

@@ -1,30 +1,35 @@
-## Get started rewrites
-rewrite /getting-started/developers/(.*) /get-started/develop/\$1 permanent;
-rewrite /getting-started/designers /get-started/design permanent;
-rewrite /getting-started/about-carbon /get-started/about-carbon permanent;
-rewrite /get-started/design/?$ /get-started/design/sketch permanent;
-
-# Tutorial rewrites
-rewrite /tutorial/react-(.*) /tutorial/react/\$1 permanent;
-rewrite /tutorial/wrapping-up /tutorial/react/wrapping-up permanent;
-rewrite /tutorial/overview /tutorial/react/overview permanent;
-
-# Contributions rewrites
-rewrite /contributions/(.*) /how-to-contribute/\$1 permanent;
-
 # Guidelines rewrites
 rewrite /guidelines/iconography/(.*) /guidelines/icons/\$1 permanent;
 rewrite /guidelines/layout /guidelines/2x-grid/basics/\$1 permanent;
 rewrite /guidelines/content/glossary /guidelines/content/action-labels permanent;
 
-# Updates rewrites
-rewrite /updates/roadmap /updates/whats-new permanent;
-
-
 # Experimental -> Cloud, Data, and AI
 rewrite /experimental/cards/(.*) https://pages.github.ibm.com/CDAI-design/CDAI-design-website/components/card/\$1 permanent;
 rewrite /experimental/dashboard-widgets/(.*) https://pages.github.ibm.com/CDAI-design/CDAI-design-website/components/widget/\$1 permanent;
 rewrite /experimental/order-summary-template/(.*) https://pages.github.ibm.com/CDAI-design/CDAI-design-website/patterns/order-summary/\$1 permanent;
 
 # Experimental -> community
-rewrite /experimental/(.*) /community/patterns/\$1 permanent;
+rewrite /experimental/(.*) /community/patterns/\$1 permanent;
+
+# IA Updates 8/2020
+# All about Carbon
+rewrite /get-started/about-carbon /all-about-carbon/what-is-carbon permanent;
+
+# Designing
+rewrite /get-started/design/(.*) /designing/get-started/kits/\$1 permanent;
+
+# Contributions rewrites
+rewrite /how-to-contribute/(.*) /contributing/\$1 permanent;
+
+# What's happening
+rewrite /updates/whats-new /whats-happening/changelog-and-roadmap permanent;
+rewrite /updates/work-in-progress /whats-happening/work-in-progress permanent;
+
+# Help
+rewrite /updates/migration-guide/(.*) /help/migration-guide/\$1 permanent;
+rewrite /help/support /help/contact-us permanent;
+rewrite /help/faq /help/faqs permanent;
+
+# Developing
+rewrite /get-started/develop/(.*) /developing/frameworks/\$1 permanent;
+rewrite /tutorial/(.*) /developing/\$1 permanent;

src/data/nav-items.yaml

@@ -1,19 +1,64 @@
-- title: Get started
+- title: All about Carbon
   pages:
-    - title: About Carbon
-      path: /get-started/about-carbon
-    - title: Design
-      path: /get-started/design/sketch
-    - title: Develop
-      path: /get-started/develop/react
-- title: Tutorial
+    - title: What is Carbon?
+      path: /all-about-carbon/what-is-carbon
+    - title: Case studies
+      path: /all-about-carbon/case-studies
+- title: Designing
   pages:
-    - title: Angular
-      path: /tutorial/angular/overview
-    - title: React
-      path: /tutorial/react/overview
-    - title: Vue
-      path: /tutorial/vue/overview
+    - title: Get started
+      path: /designing/get-started
+    - title: Kits
+      path: /designing/kits/sketch
+    - title: Design resources
+      path: /designing/design-resources
+    - title: Tutorials
+      path: /designing/tutorials
+- title: Developing
+  pages:
+    - title: Get started
+      path: /developing/get-started
+    - title: Frameworks
+      path: /developing/frameworks/react
+    - title: Developer resources
+      path: /developing/dev-resources
+    - title: Angular tutorial
+      path: /developing/angular-tutorial/overview
+    - title: React tutorial
+      path: /developing/react-tutorial/overview
+    - title: Vue tutorial
+      path: /developing/vue-tutorial/overview
+- title: Contributing
+  pages:
+    - title: Overview
+      path: /contributing/overview
+    - title: Governance
+      path: /contributing/governance
+    - title: Bugs and requests
+      path: /contributing/bugs-and-requests
+    - title: Documentation
+      path: /contributing/documentation
+    - title: Components
+      path: /contributing/component
+    - title: Icons
+      path: /contributing/contribute-icons
+    - title: Patterns
+      path: /contributing/pattern
+    - title: Pictograms
+      path: /contributing/contribute-pictograms
+    - title: Add ons
+      path: /contributing/add-ons
+- title: What's happening
+  pages:
+    - title: Changelog & roadmap
+      path: /whats-happening/changelog-and-roadmap
+    - title: News & articles
+      path: /whats-happening/news-and-articles
+    - title: Events
+      path: /whats-happening/events
+    - title: Work in progress
+      path: /whats-happening/work-in-progress
+  hasDivider: true
 - title: Guidelines
   pages:
     - title: 2x Grid
@@ -140,6 +185,16 @@
       path: /patterns/search-pattern
     - title: Text toolbar
       path: /patterns/text-toolbar-pattern
+- title: Community assets
+  pages:
+    - title: Overview
+      path: /community-assets/overview
+    - title: Component index
+      path: /community-assets/component-index
+    - title: Domain guidance
+      path: /community-assets/domain-guidance
+    - title: Pattern index
+      path: /community-assets/pattern-index
 - title: Data visualization
   pages:
     - title: Get started
@@ -160,50 +215,13 @@
       path: /data-visualization/legends
     - title: Dashboards
       path: /data-visualization/dashboards
-- title: Resources
-  pages:
-    - path: /resources
-- title: How to contribute
-  pages:
-    - title: Overview
-      path: /how-to-contribute/overview
-    - title: Governance
-      path: /how-to-contribute/governance
-    - title: Bugs and requests
-      path: /how-to-contribute/bugs-and-requests
-    - title: Documentation
-      path: /how-to-contribute/documentation
-    - title: Components
-      path: /how-to-contribute/component
-    - title: Icons
-      path: /how-to-contribute/contribute-icons
-    - title: Patterns
-      path: /how-to-contribute/pattern
-    - title: Pictograms
-      path: /how-to-contribute/contribute-pictograms
-    - title: Add ons
-      path: /how-to-contribute/add-ons
-- title: Updates
-  pages:
-    - title: Changelog and roadmap
-      path: /updates/whats-new
-    - title: Migration guide
-      path: /updates/migration-guide/overview
-    - title: Work in progress
-      path: /updates/work-in-progress
 - title: Help
   pages:
-    - title: Support
-      path: /help/support
-    - title: FAQ
-      path: /help/faq
-- title: Community assets
-  pages:
-    - title: Overview
-      path: /community/overview
-    - title: Components
-      path: /community/components
-    - title: Patterns
-      path: /community/patterns
-    - title: Domain guidance
-      path: /community/domain-guidance
+    - title: FAQs
+      path: /help/faqs
+    - title: Certificate of Originality
+      path: /help/certificate-of-originality
+    - title: Migration guide
+      path: /help/migration-guide/overview
+    - title: Contact us
+      path: /help/contact-us

src/gatsby-theme-carbon/components/Footer.js

@@ -35,8 +35,8 @@ const Content = ({ buildTime }) => (
 const links = {
   firstCol: [
     {
-      href: 'https://www.carbondesignsystem.com/how-to-contribute/overview',
-      linkText: 'Contribute',
+      href: 'https://www.carbondesignsystem.com/help/contact-us',
+      linkText: 'Contact us',
     },
     { href: 'https://www.ibm.com/privacy', linkText: 'Privacy' },
     { href: 'https://www.ibm.com/legal', linkText: 'Terms of use' },

src/pages/all-about-carbon/case-studies.mdx

@@ -0,0 +1,11 @@
+---
+title: Case studies
+description: Introductory text for the new case studies page.
+---
+
+<PageDescription>
+
+Introductory text for the new case studies page. We'll be sharing more case
+studies here as they become available.
+
+</PageDescription>

src/pages/all-about-carbon/what-is-carbon.mdx

@@ -0,0 +1,112 @@
+---
+title: What is Carbon?
+description:
+  Carbon is IBM's open source design system for digital products and
+  experiences. With the IBM Design Language as its foundation, the system
+  consists of working code, design tools, and more.
+---
+
+<PageDescription>
+
+Carbon is IBM's open source design system for digital products and experiences.
+With the IBM Design Language as its foundation, the system consists of working
+code, design tools and resources, human interface guidelines, and a vibrant
+community of contributors.
+
+</PageDescription>
+
+<AnchorLinks>
+
+<AnchorLink>Introduction</AnchorLink>
+<AnchorLink>Guiding principles</AnchorLink>
+<AnchorLink>How we work</AnchorLink>
+
+</AnchorLinks>
+
+## Introduction
+
+As IBM's official design system, Carbon serves a wide range of designers and
+developers building digital products and experiences. It is maintained by a core
+team of designers, developers, and writers based in the Austin, Texas IBM Design
+Studio.
+
+The goals of the design system include improving UI consistency and quality,
+making the design and development process more efficient and focused,
+establishing a shared vocabulary between designer and developer, and providing
+clear, discoverable guidance around design and development best practices.
+
+The design system is built [React](/get-started/develop/react) first. We also
+support core parts of the system in [vanilla JS](/get-started/develop/vanilla),
+[Angular](/get-started/develop/angular), and [Vue](/get-started/develop/vue). If
+you’re using a different framework, you can still build components by following
+our guidelines for [other frameworks](/get-started/develop/other-frameworks).
+
+## Guiding principles
+
+**Carbon is open.** The design system is a distributed effort, guided by the
+principles of the
+[open source movement](https://en.wikipedia.org/wiki/Open-source-software_movement).
+Carbon's users are also its makers, and everyone is encouraged to contribute.
+
+**Carbon is inclusive.** It's designed and built to be accessible to all,
+regardless of ability or situation.
+
+**Carbon is modular and flexible.** The system's modularity ensures maximum
+flexibility in execution. Its components are designed to work seamlessly with
+each other, in whichever combination suits the needs of the user.
+
+**Carbon puts the user first.** Using rigorous research into users' needs and
+desires, Carbon is laser-focused on real people.
+
+**Carbon builds consistency.** Based on the IBM Design Language, every element
+and component of Carbon was designed from the ground up to work elegantly
+together to ensure consistent, cohesive user experiences.
+
+## How we work
+
+The Carbon team encourages adoption through guidance and training, community
+development, maintenance, and support. The system is primarily maintained by a
+core team and governed by an executive board of design advisors.
+
+### Adoption
+
+**We conduct training classes and offer certifications.** These cover
+introductions to Carbon and participating in this community. Each program is
+piloted internally and available upon release externally. We teach at
+conferences, bootcamp labs, and wherever else we're needed.
+
+**We engage the community.** We strive to be one of the world’s best design
+systems and we’re always
+[open to feedback](https://github.com/carbon-design-system/carbon-website/issues/new?assignees=&labels=feedback&template=feedback.md&title=).
+We communicate with you about Carbon's state and roadmap through GitHub support,
+blog posts, and Twitter.
+
+**Contributed components and patterns include a list of maintainers.** The
+Carbon team triages and supports maintenance requests that do not have a
+maintainer. Unmaintained patterns will be demoted to Experimental if the Carbon
+team decides not to maintain them.
+
+**We provide support for users of the design system.** The Carbon team engages
+with users primarily through GitHub. A member of the Carbon team responds to all
+issues and pull requests.
+
+### Assets
+
+**We maintain a set of Sketch libraries containing Carbon components and
+patterns.** There is a funnel of contribution for rigorous Sketch symbols before
+they are made available in Sketch libraries.
+
+**Carbon supports multiple code implementations.** These reflect the
+production-level design libraries. The frameworks are listed below with their
+primary maintainers:
+
+- [React](https://github.com/carbon-design-system/carbon): Carbon Core team
+- [CSS/Vanilla](https://github.com/carbon-design-system/carbon): Carbon Core
+  team
+- [Angular](https://angular.carbondesignsystem.com/): Community maintained
+- [Vue](https://github.com/carbon-design-system/carbon-components-vue):
+  Community maintained
+
+**Design patterns are harvested from products built with Carbon.** These become
+part of the design system. Teams can use these well-defined patterns in their
+work and contribute patterns back to the system.