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 1 commit
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
98 changes: 42 additions & 56 deletions src/pages/help/faq/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,16 +5,25 @@ 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>

## All about Carbon
jillianhowarth marked this conversation as resolved.
Show resolved Hide resolved

### 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
[All about Carbon](/all-about-carbon/what-is-carbon).
jillianhowarth marked this conversation as resolved.
Show resolved Hide resolved

### 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
Expand All @@ -25,36 +34,22 @@ who contribute back to
and
[carbon-react](https://github.com/carbon-design-system/carbon-components-react#contributors).

## Contributing

### How can I contribute and/or propose new components/ideas?
jillianhowarth marked this conversation as resolved.
Show resolved Hide resolved

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
jillianhowarth marked this conversation as resolved.
Show resolved Hide resolved
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

- [Design kit](https://github.com/carbon-design-system/carbon-design-kit/issues/new)
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?

Carbon components are supported in the following browsers:

### I'm an internal IBM team and want to know about COO status. Is there an approval on file?
- IE11
- Microsoft Edge latest
- Firefox latest
- Chrome latest
- Safari latest

Carbon v10.x
### What languages are the components written in?

- 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
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.

Carbon v9.x
### Where do I find mobile components?

- 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
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 @@ -146,17 +138,11 @@ 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" />

If keeping the number of columns to three is essential, here are some other
options.
### I haven't updated to the latest version of Carbon yet, and I still need the old documentation. Where can I find it?
jillianhowarth marked this conversation as resolved.
Show resolved Hide resolved

![3 col layouts on Duo grid](images/3col-layouts.png)
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/).**