Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: FAQs update #1658

Merged
merged 8 commits into from
Sep 4, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
117 changes: 49 additions & 68 deletions src/pages/help/faq/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,55 +5,50 @@ description:
Here, we answer some of our frequently asked questions.
---

<PageDescription>
<AnchorLinks>

What is the Carbon Design System?
<AnchorLink>About Carbon</AnchorLink>
<AnchorLink>Contributing</AnchorLink>
<AnchorLink>Creating with Carbon</AnchorLink>

</PageDescription>
</AnchorLinks>

## About Carbon

### What is the Carbon Design System?

Carbon is the open-source design system for all IBM software products. It is a
series of individual styles, components, and guidelines used for creating
unified product experiences.

To learn more about how we work check out
[What is Carbon](/all-about-carbon/what-is-carbon).

### Who works on Carbon?
jillianhowarth marked this conversation as resolved.
Show resolved Hide resolved

Carbon has a core team of designers and front-end developers dedicated to
developing and supporting the system. Our core team sits in the IBM Design
Studio in Austin, Texas. There are also countless other designers and developers
who contribute back to
developing and supporting the system. There are also countless other designers
and developers who contribute back to
[carbon-components](https://github.com/carbon-design-system/carbon-components#contributors)
and
[carbon-react](https://github.com/carbon-design-system/carbon-components-react#contributors).

### How can I contribute and/or propose new components/ideas?
## Contributing

### How can I contribute and/or propose new components or ideas?

Check out our [contribution overview](/contributing/overview) to learn all about
the different ways to contribute. Thanks for the help!

### Which browsers are supported?

Carbon components are supported in the following browsers:

- IE11
- Microsoft Edge latest
- Firefox latest
- Chrome latest
- Safari latest

### What languages are the components written in?

There are four different implementations of the Carbon Design System. One is a
vanilla JavaScript library; that's written in ES6+, SCSS, and HTML and ships
deliverables in vanilla JavaScript in ES5 as well as ES6, CSS, SCSS and HTML.
Another is a React library that ships a React rewrite of the JavaScript, but
uses the same CSS as the core library. There are also Angular and Vue libraries
that use the same CSS.

### I see a bug. How do I report it?

First, make sure the problem is reproducible. Once confirmed, open an issue in
the appropriate GitHub repo (see below). We will address the bug as soon as we
can. If you have a fix for the bug, please feel free to submit a PR for it.
the appropriate GitHub repo from the following list. We will address the bug as
soon as we can. If you have a fix for the bug, please feel free to submit a PR
for it.

For larger changes, please see our
[contribution overview](/contributing/overview).

#### Design issue repos

Expand Down Expand Up @@ -99,33 +94,30 @@ in the Components repo and describe the steps to reproduce the problem. If the
core Carbon team confirms the problem, we will work to fix it as quickly as
possible.

### I haven't updated to the latest version of Carbon yet, and I still need the old documentation. Where can I find it?
## Creating with Carbon

Every version of Carbon that is still supported is hosted at its own domain. You
can find the old sites version here:
**[V6](http://v6.carbondesignsystem.com/)**,
**[V7](http://v7.carbondesignsystem.com/)**,
**[V8](http://v8.carbondesignsystem.com/)**, and
**[V9](http://v9.carbondesignsystem.com/).**
### Which browsers are supported?

### I'm an internal IBM team and want to know about COO status. Is there an approval on file?
Carbon components are supported in the following browsers:

Carbon v10.x
- IE11
- Microsoft Edge latest
- Firefox latest
- Chrome latest
- Safari latest

- COO record ID: 95607540
- COO reference number: COO20190204
- Name of IBM material (with version number): IBM Design System [Version 10,
Release n/a, Modification n/a]
- Last release date: March 31, 2019
- Name of Product/Program manager or author of material: Matt Rosno/US/IBM
### What languages are the components written in?

Carbon v9.x
Carbon is built React first. We also support vanilla JS, Angular, and Vue
implementations. Check out [Frameworks](/developing/frameworks/react) to learn
more about what you need to get started with Carbon implementations.

- COO number of IBM material (if any): AUS720180239
- Name of IBM material (with version number): IBM Design System [Version 9,
Release n/a, Modification n/a]
- Last release date: June 4, 2018
- Name of Product/Program manager or author of material: Matt Rosno/US/IBM
### Where do I find mobile components?

We are currently working on a Carbon mobile Sketch kit. This kit is a work in
progress but is an opportunity for you to preview what we're working on and
provide early feedback. Find the kit on the
[Work in progress](/whats-happening/work-in-progress) page.

### Where do I find the Experimental components and patterns?

Expand All @@ -139,24 +131,13 @@ sites and is only accessible to IBMers.

### Where do I find charts and data visualization?

Carbon charts are in development and classified as experimental. Check out the
[experimental charts repo](https://carbon-design-system.github.io/carbon-charts/?experimental=true)
to explore the work so far.

These charts will receive an updated color palette to match Carbon v10. Visual
guidance and chart components are also in the works!

### How do I migrate an existing design from a 12-column grid to the 16-column grid?

There are many ways to move content from a 12-column grid onto a 16-column grid.
If keeping the number of columns unchanged is not important to you, see below
examples.

<Video vimeoId="356743483" />
<Video vimeoId="356743492" />
<Video vimeoId="356743508" />
Carbon charts and their corresponding assets and documentation are now in the
[Data visualization](/data-visualization/getting-started) section.

If keeping the number of columns to three is essential, here are some other
options.
### Where can I find documentation for earlier versions of Carbon?

![3 col layouts on Duo grid](images/3col-layouts.png)
You can find earlier versions of Carbon documentation here:
**[V6](http://v6.carbondesignsystem.com/)**,
**[V7](http://v7.carbondesignsystem.com/)**,
**[V8](http://v8.carbondesignsystem.com/)**, and
**[V9](http://v9.carbondesignsystem.com/).**