소음 없는 UI
사람이 사용할 수 있는 인터페이스를 만들고, 인터페이스에 대한 설명을 만들지 마세요. 기본적으로 컨트롤, 그 이름, 관련 객체, 필요한 상태를 표시하세요. 사용자의 이해, 결정, 다음 작업 또는 위험 평가를 바꾸는 경우에만 추가 설명을 추가하세요.
생성 중
- 설명용 장식부터 추가하지 마세요. 모든 섹션에 자동으로 부제목, 소개 문단, 도움말 카드, 배너, 눈썹(eyebrow), 배지 또는 아이콘을 추가하지 마세요. 공간을 채우거나 페이지가 완성된 것처럼 보이게 하기 위해서가 아니라, 구체적인 사용자 필요에 의해서만 추가하세요.
- 인터페이스가 설명하게 하세요. 구체적인 레이블, 친숙한 동사, 그룹화, 배치를 선호하세요. "작업 공간 만들기"에 "아래를 클릭하여 작업 공간을 만드세요"가 필요하지 않습니다. 레이블이 불명확하다면 문단을 추가하기 전에 레이블을 수정하세요.
- 구현에 대해 설명하지 마세요. 아키텍처, 컴포넌트 선택, 일반적인 신뢰 부인, 개발자 진행 보고서는 기본 제품 카피가 아닙니다. 개인정보, 범위, 복구 또는 사용자의 다음 결정에 영향을 미치는 기술적 사실은 유지하세요.
- 각 정보는 유용한 곳에 말하세요. 제목, 배지, 문장, 배너는 동일한 범위에서 같은 사실을 반복해서는 안 됩니다. 필드와 연결된 오류 요약이나 명확한 중대한 작업 옆의 경고와 같은 의도적인 반복은 유지하세요. 객체, 요청 또는 작업 공간 간에 상태를 병합하지 마세요.
- 빈 컨테이너도 함께 제거하세요. 중복 카피를 제거할 때는 이제 쓸모없는 카드, 알림, 아이콘, 구분선 또는 예약된 공간도 제거하세요. 문단을 장식용 배지나 아이콘 행으로 대체하지 마세요. 불필요한 카피를 툴팁, 펼치기(disclosure), 작은 글씨, 낮은 대비로 숨기지 마세요.
- 안전하게 행동하는 데 필요한 정보는 유지하세요. 연결된, 일반적으로 보이는 필드 레이블; 실제 형식/길이/필수 제약 조건; 실행 가능한 오류; 의미 있는 로딩, 저장되지 않음, 사용 불가, 권한 및 알 수 없는 상태; 위험한 작업의 범위와 결과를 유지하세요. 알 수 없음은 비어 있음, 성공 또는 실패가 아닙니다. 사용할 수 없는 기능이 작동하는 것처럼 암시하지 마세요.
- 필요한 정보는 읽을 수 있게 만드세요. 중요한 상태와 비활성화된 작업 이유는 해당 범위 근처에 시각적으로 표시되어야 하며, 스크린 리더 전용 또는 호버 전용이 아니어야 합니다. 접근 가능한 이름, 설명, 라이브 리전 긴급도, 키보드 접근, 좁은 화면 가독성을 유지하세요. 간결함이 접근성을 무시하지 않습니다.
- 실수로 제품을 축소하지 마세요. 기능, 데이터, 작업, 확인, 권한 부여, 요청/재시도 동작을 유지하세요. 불명확한 비즈니스 또는 안전 요구 사항을 삭제하지 말고, 대신 소유자에게 특정 모호성을 표시하세요.
변경된 화면을 넘기기 전
사용 가능한 경우 분리된 문자열뿐만 아니라 렌더링된 화면을 검토하세요. 각 지원 문자열과 그 컨테이너에 대해 다음 결과 중 하나를 선택하세요:
- 유지: 필요한 사실, 구분, 제약 조건, 결과 또는 다음 단계를 추가합니다.
- 다시 쓰기: 사실은 필요하지만 표현이 모호하거나 반복되거나 필요 이상으로 깁니다.
- 병합: 동일한 범위에서 같은 사실을 반복합니다. 유용한 배치와 연관성을 유지합니다.
- 삭제: 인터페이스가 이미 그것을 전달하고 있으며 필요한 의미가 손실되지 않습니다. 빈 컨테이너를 제거합니다.
- 이동: 진정으로 빈도가 낮은 도움말만 명시적이고 접근 가능한 도움말 항목 뒤에 속합니다. 일반적인 작업이나 중요한 상태를 묻지 마세요.
해당되는 경우 일반, 빈, 오류, 사용 불가, 알 수 없는 상태에서 변경된 범위를 확인하세요. 영향을 받는 경우 삭제 확인, 키보드 탐색, 좁은 뷰포트를 포함하세요. 실행되지 않은 브라우저 또는 접근성 확인을 주장하지 마세요.
중요한 변경사항은 간결하게 이전 → 이후 — 이유 형식으로 보고하고, 의도적으로 유지된 필요한 사실을 포함하세요. 제품에 새로운 설명 에세이를 쓰거나 간결함을 증명하기 위해 점수 시스템을 발명하지 마세요.
예시
| 이전 | 이후 / 결정 |
|---|---|
| 작업공간 · 여기서 작업공간을 관리하고 구성하세요 | 작업공간 — 반복된 설명을 삭제합니다. |
| 아래 버튼을 클릭하여 새 프로젝트를 만드세요 / 프로젝트 만들기 | 프로젝트 만들기 — 실제 작업을 유지합니다. |
| 프로젝트 이름 / 여기에 프로젝트 이름을 입력하세요 | 프로젝트 이름 — 레이블을 유지하고 명백한 지침을 제거합니다. |
| 파일 / CSV만 지원, 최대 20 MB | 둘 다 유지 — 두 번째 줄은 실제 제약 조건입니다. |
| 저장됨 + 저장 성공 + 변경사항이 저장되었습니다 | 필요한 경우 적절한 범위의 확인 한 번; 동의어 쌓지 않음. |
| 저장 결과를 알 수 없습니다. 먼저 이 결과를 확인하고 중복 저장하지 마세요. | 유지 — 불확실성과 안전한 다음 단계가 중요합니다. |
| "여행 계획"과 그 안의 12개 노트를 영구 삭제하며 복구할 수 없습니다. | 객체, 범위, 개수 및 결과를 유지합니다. |
경계
이 스킬은 모델 지침이며, 린터, 자동 훅 또는 준수 증명이 아닙니다. 프로젝트의 기존 용어, 제품 및 안전 계약을 따르세요. 경쟁 사양을 도입하거나, 종속성을 설치하거나, 외부 서비스에 연락하거나, 이 스킬을 사용하기 위해 전역 구성을 변경하지 마세요. 예시는 언어에 민감합니다: 일관된 용어를 유지하세요. 영어 단어 수, 문학적 동의어 변형, 보편적인 글꼴 수 또는 모든 줄에 아이콘을 강요하지 마세요.