FAQs

FAQs (자주 묻는 질문)

Carbon 디자인 시스템에 대해 자주 묻는 질문과 답변을 모은 페이지예요. Carbon에 대해, 기여하는 방법, Carbon으로 만들 때, 텔레메트리(telemetry)에 관한 내용을 다룹니다.

출처: FAQs

본문

Carbon에 대해 (About Carbon)

Carbon 디자인 시스템이란 무엇인가요? (What is the Carbon Design System?)

Carbon은 모든 IBM 소프트웨어 제품을 위한 오픈소스 디자인 시스템이에요. 통합된 제품 경험을 만드는 데 사용되는 개별 스타일, 컴포넌트, 가이드라인의 시리즈입니다.

우리가 어떻게 일하는지 더 알아보려면 What is Carbon을 확인하세요.

누가 Carbon에서 일하나요? (Who works on Carbon?)

Carbon에는 시스템을 개발하고 지원하는 데 헌신하는 디자이너와 프론트엔드 개발자의 코어 팀이 있어요. 또한 carbon-react에 기여하는 수많은 다른 디자이너와 개발자도 있습니다.

기여하기 (Contributing)

어떻게 기여하고/새 컴포넌트나 아이디어를 제안할 수 있나요? (How can I contribute and/or propose new components or ideas?)

다양한 기여 방법을 모두 알아보려면 contribution get started 페이지를 확인하세요. 도움 감사합니다!

버그를 발견했어요. 어떻게 신고하나요? (I see a bug. How do I report it?)

먼저 문제가 재현 가능한지 확인하세요. 확인되면 다음 목록에서 적절한 GitHub 저장소에 이슈를 여세요. 가능한 한 빨리 버그를 처리하겠습니다. 버그에 대한 수정이 있다면 PR을 제출해 주세요.

더 큰 변경 사항은 contribution get started 페이지를 참고하세요.

디자인 이슈 저장소 (Design issue repos)

Design kit
Icons
Website
Components
Elements
Charts
Everything else

코드 저장소 (Code repos)

@carbon/react
@carbon/web-components
carbon-components-angular
carbon-components-vanilla
carbon-components-vue
carbon-charts

버그 신고에 대한 응답은 어떻게 기대할 수 있나요? (What can I expect for a response to my bug report?)

시급한 버그나 변경이 있다면 이슈에 직접 PR을 만드는 것이 가장 좋아요. 우리 팀은 스프린트로 일하며 가능한 한 빨리, 때로는 이삼일 내에, 하지만 보통 다음 스프린트까지 버그를 처리하려고 합니다. 범위 밖의 이슈는 더 높은 우선순위가 될 때까지 닫아둡니다.

버그 신고에 대한 일반적인 응답은 다음과 같아요.

더 많은 정보 필요, 문제를 재현할 수 없음
수정하지 않음, 지원할 의도가 없음
확인됨, 로드맵에 추가하겠음 (Carbon 팀이 수정)
확인됨, PR 수락하겠음 (외부 구성원의 수정 필요)
이 동작이 지원되는지 확인하려면 디자인을 포함해야 함

접근 불가능한 컴포넌트를 발견하면 어떻게 해야 하나요? (What should I do if I find a component that isn’t accessible?)

먼저 Carbon 접근성 가이드라인을 참조해 컴포넌트가 접근성 표준을 충족하지 못하는지 확인하세요. 확인되면 Components 저장소에 GitHub 이슈를 생성하고 문제를 재현하는 단계를 설명하세요. Carbon 코어 팀이 문제를 확인하면 가능한 한 빨리 수정하기 위해 노력하겠습니다.

Carbon으로 만들기 (Creating with Carbon)

어떤 브라우저가 지원되나요? (Which browsers are supported?)

Carbon 컴포넌트는 다음 브라우저에서 지원됩니다.

Microsoft Edge 최신
Firefox 최신
Chrome 최신
Safari 최신

IBM 팀은 여기에서 브라우저 지원 표준을 확인하세요.

컴포넌트는 어떤 언어로 작성되나요? (What languages are the components written in?)

Carbon은 React 기반으로 구축되며 Web Components에 대한 공식 지원이 있습니다. vanilla JS, Angular, Vue, Svelte 구현에는 커뮤니티 지원이 존재합니다. Carbon 구현 시작에 필요한 것에 대해 알아보려면 Frameworks를 확인하세요.

모바일 컴포넌트는 어디에서 찾나요? (Where do I find mobile components?)

Carbon Native 모바일 Figma 키트는 Other resources 페이지에서 사용 가능합니다.

기능 플래그란 무엇인가요? 어디서 찾나요? (What are feature flags? Where do I find them?)

기능 플래그는 새 동작과 스타일링을 활성화해, 사용자가 현재 메이저 버전에 머무르면서 새 브레이킹 변경에 옵트인할 수 있게 해줘요. 사용 가능한 기능 플래그가 있는 컴포넌트 목록은 Component Overview 페이지의 Feature flags 탭에서 찾을 수 있습니다. 향후 다음 메이저 릴리스(v12)가 출시되면 기능 플래그가 컴포넌트의 기본 버전이 됩니다.

프리뷰(preview) 컴포넌트란 무엇인가요? 어디서 찾나요? (What are preview components? Where do I find them?)

팀은 가끔 프리뷰 또는 불안정(unstable)으로 간주되는 코드를 작성하거나 기여를 수락합니다. 이 코드의 목표는 스폰서 그룹이 활용할 수 있도록 불안정 상태로 제공하는 것입니다. 이 기간 동안 팀은 무엇이 잘 작동하고 무엇이 작동하지 않는지에 대한 피드백을 받아 공식 릴리스 전에 변경할 수 있습니다. storybook의 Preview 탭에서 사용 가능합니다.

커뮤니티 에셋은 어디에서 찾나요? (Where do I find the community assets?)

프리뷰에 있던 패턴과 컴포넌트는 이제 Community assets 섹션에 있어요. 커뮤니티 에셋에는 Carbon을 사용하는 개인과 팀이 개발하고 유지 관리하는 작업이 포함됩니다. 피드백, 코드, 디자인을 기여해 이 리소스를 끌어올리는 데 도울 수 있습니다.

커뮤니티 에셋의 일부 콘텐츠는 내부 IBM 사이트에서 호스팅되며 IBM 직원만 접근할 수 있다는 점에 유의하세요.

차트와 데이터 시각화는 어디에서 찾나요? (Where do I find charts and data visualization?)

Carbon 차트와 해당 에셋 및 문서는 이제 Data visualization 섹션에 있습니다.

이전 버전의 Carbon 문서는 어디에서 찾을 수 있나요? (Where can I find documentation for earlier versions of Carbon?)

이전 버전의 Carbon 문서는 여기에서 찾을 수 있습니다: V6, V7, V8, V9, V10.

텔레메트리 (Telemetry)

Carbon에는 IBM과 Carbon 디자인 시스템 속성에 대한 사용 정보를 수집하는 텔레메트리 기능이 포함되어 있어요.

텔레메트리는 왜 수집되나요? (Why is telemetry collected?)

Carbon은 텔레메트리 정보를 수집해 Carbon 로드맵에 영향을 주고 버그 수정에 우선순위를 둡니다.

데이터는 언제 수집되나요? (When is data collected?)

데이터는 Carbon 패키지가 CI(Continuous Integration) 서버에 설치될 때, 설치가 PR(Pull Request)의 일부가 아닐 때, 그리고 origin remotes가 다음과 같은 Git 저장소에 대해 수집됩니다.

github.ibm.com
github.com/ibm
github.com/carbon-design-system

수집되는 정보는 익명이 아니기 때문에, 텔레메트리 데이터 수집은 IBM GitHub Enterprise 저장소와 IBM 및 Carbon 디자인 시스템 GitHub 조직의 오픈소스 저장소로 제한됩니다.

무엇이 수집되나요? (What is being collected?)

다음은 postinstall 스크립트를 통해 수집됩니다.

Git 저장소 remote origin URL과 커밋 해시
저장소에서 사용되는 패키지와 패키지 버전
파일 경로와 패키지를 포함한 사용 중인 컴포넌트
사용 중인 컴포넌트 props (prop 값은 문자열로 직렬화 가능할 때만 수집됨)

어떻게 옵트아웃하나요? (How do I opt out?)

Carbon 텔레메트리 참여는 선택사항이에요. 옵트아웃하려면 환경 변수 CARBON_TELEMETRY_DISABLED를 1로 설정하세요.

더 알아보기 (Learn more)

FAQ에서는 Carbon 소개, 기여 방법, 브라우저·언어 지원, 모바일·커뮤니티·차트 리소스 위치, 이전 버전 문서, 텔레메트리 수집 방식까지 핵심 질문을 다뤄요. 버그 신고는 관련 GitHub 저장소에, 기여는 contribution 가이드로 시작하면 됩니다. 텔레메트리는 기본 수집되지만 환경 변수로 쉽게 끌 수 있어요.