Dot Content & Accessibility
Dot의 목소리와 기본 접근성 계약을 빠르게 확인합니다.
Voice
- 짧고 차분한 한국어
- 제목·메뉴는 명사형, 행동은 결과가 분명한 동사형
- 설명과 피드백은 자연스러운 해요체
- 내부 엔티티명보다 운영자가 이해하는 용어 우선
Action writing
| 피한다 | 사용한다 |
|---|---|
| 확인 | 커리큘럼 발행 |
| 저장 | 초안 저장 |
| 실행 | 검증 실행 |
| OK | 변경 없이 나가기 |
| 에러가 발생했습니다 | 질문 2개의 기준 답안을 입력하면 검증할 수 있어요 |
버튼만 읽어도 클릭 결과를 예측할 수 있어야 한다. 로딩 중에는 저장 중…, 검증 중…처럼 진행 중인 작업을 유지한다.
Error writing
- 무엇을 끝내지 못했는지 말한다.
- 사용자가 지금 할 수 있는 복구 행동을 말한다.
- 기술 식별자는 필요할 때만 보조 정보로 제공한다.
예: 커리큘럼을 불러오지 못했어요. 잠시 후 다시 시도하거나 서버 연결 상태를 확인해주세요.
Accessibility contract
- 문서 제목 계층은 h1→h2→h3 순서를 지킨다.
- form control에는 programmatic label이 있다.
- icon-only action은 접근 가능한 이름을 가진다.
- 선택·성공·경고·실패를 색만으로 전달하지 않는다.
- focus indicator를 제거하지 않는다.
- dialog가 열리면 focus가 내부로 이동하고 닫히면 trigger로 돌아간다.
- 로딩 상태는
aria-busy, 결과 변화는 필요한 경우 live region을 사용한다. - motion 감소 설정에서는 비필수 모션을 제거한다.
- 중요한 조작은 hover 없이도 보인다.
- 표를 작은 화면에서 목록으로 전환할 때도 모든 핵심 정보와 행동을 유지한다.