디자인 시스템 문서를 만들고 최신 상태로 유지하기

## 원칙부터 구성 요소까지 디자인 시스템 문서의 범위 정하기 시스템의 무형 기반인 원칙, 결정, 업무 방식과 유형 자산인 패턴, 구성 요소, 사용 규칙, 구현 도구를 모두 문서화하세요. 작성하기 전에 범위를 명확히 보여 주어, 누락된 항목이 뜻밖의 문제가 아니라 백로그 항목이 되게 하세요. ## 문서를 페이지로 나누고 가장 불편한 곳부터 쓰기 작업을 자체적으로 완결된 페이지로 나누세요. 가장 큰 마찰을 일으키는 영역을 먼저 처리한 다음, 자주 사용되거나 의존성이 많은 구성 요소를 우선하세요. 진행 상황을 추적하고 제약이 바뀌면 우선순위를 검토하세요. 팀이 안정적으로 유지 관리하고 검색하며 공유할 수 있는 도구라면 무엇이든 사용하세요. ## 구성 요소마다 네 가지 질문에 답하며 설명하기 모든 구성 요소에 대해 네 가지 질문에 답하세요. 상태와 선택지를 포함해 이것은 무엇인가요? 비슷한 대안 대신 이것을 선택하는 이유는 무엇인가요? 어떤 맥락에서 이것이 적절한가요? 지원되는 변형, 예시, 명시적으로 해야 할 일과 하지 말아야 할 일을 포함해 어떻게 사용해야 하나요? ## 디자이너와 개발자용을 먼저 쓰고 다른 담당자용은 짧게 정리하기 명확한 동작, 의사결정 기준, 구현 참고 자료, 코드 링크나 스토리 링크를 제공하여 디자이너와 개발자를 먼저 지원하세요. 제품, QA, 연구 역할에는 더 짧은 검증 경로를 제공하세요. 다른 시스템의 강력한 패턴을 재사용하되 상황에 맞게 조정하세요. 실제로 접근해 사용할 수 있는지가 시각적 완성도보다 중요합니다. ## 출시 전에 문서와 디자인, 코드가 맞는지 확인하기 문서를 지속적으로 발전하는 제품으로 다루세요. 디자인 검토에서 새로운 구성 요소와 지침을 검토하고, 프로젝트 시작 시 문서화 필요성을 평가하며, 사용자 테스트와 접근성 검사를 통해 구성 요소를 시험하고, 공개 전에 디자인, 코드, 문서의 일치를 확인하세요. 근거가 유지 관리 관행이 효과가 없음을 보여 주면 그 관행을 바꾸세요.