오류 메시지 지침

오류 메시지는 사용자 또는 시스템의 작업을 완료할 수 없는 문제가 발생했음을 설명하기 위해 표시되는 텍스트입니다. 이 문제로 인해 데이터가 손상되거나 손실될 수 있습니다. 다른 메시지 유형에는 확인, 경고 및 알림이 있습니다. 이 항목의 지침을 참고하여 지역화하기 쉽고 고객에게 유용한 명확한 오류 메시지를 작성할 수 있습니다.

오류 메시지가 잘못 작성되면 사용자가 혼란스러울 수 있으며 기술 지원 비용이 증가할 수 있습니다. 잘 작성된 오류 메시지는 사용자에게 다음 정보를 제공합니다.

• 발생한 문제와 이유
• 사용자가 얻은 최종 결과
• 문제가 다시 발생하지 않도록 사용자가 해야 할일

개발자가 버퍼 크기를 올바르게 처리하는 한 텍스트 길이는 문제가 되지 않습니다. 사용자에게 문제를 해결하는 데 필요한 모든 정보가 있어야 합니다. 메시지 대상이 여러 그룹인 경우 관리자, 최종 사용자 및 개발자용으로 별도의 텍스트를 제공해야 할 수 있습니다.

모범 사례

다음은 오류 메시지를 개선하는 방법입니다.

• 오류 조건을 방지합니다. 사용자가 특정 작업을 수행할 때 오류가 발생할 것이라고 예측할 수 있는 경우 사용자가 오류를 발생시키지 않도록 코드를 다시 작성합니다.
• 오류의 알려진 원인마다 별도의 오류 메시지를 작성합니다. 오류가 발생할 때 오류의 원인을 판별할 수 없는 경우를 제외하고 일반적인 단일 메시지를 사용하여 오류가 발생할 수 있는 모든 이유를 설명하지 마세요.
• 문제를 명확하게 명시하고 사용자에게 도움이 되면 문제의 원인을 설명합니다. 가능한 경우, 시스템 메시지 테이블 리소스의 일반 메시지를 문제와 관련된 자세한 메시지로 바꿉니다.
• 사용자에게 문제에 대한 솔루션을 제공합니다. 솔루션이 여러 단계인 경우 도움말 항목을 참조하여 작업에 대해 자세히 알아보세요.
• 메시지 제목 표시줄에 제품, 구성 요소 또는 마법사 이름만 표시합니다. 이렇게 하면 사용자가 문제가 있는 위치를 확인할 수 있습니다. 제목 표시줄에 문제를 요약하지 말고 "오류"라는 단어를 넣지 마세요.
• 기술 전문 용어를 사용하지 말고, 청중이 이해할 수 있는 용어를 사용합니다. 속어 또는 약어를 사용하지 마세요.
• 확인, 취소, 예, 아니요 및 다시 시도와 같은 적절한 명령 단추를 사용합니다. 이러한 단추를 조합하여 사용할 수 있습니다. 예 및 아니요 단추는 항상 조합하여 사용해야 하며 질문 앞에 와야 합니다.
  • 작업을 중지하고 메시지 상자를 닫으려면 취소 단추를 사용합니다.
  • 메시지 상자를 닫으려면 닫기 단추를 사용합니다.
  • 오류 원인에 대한 자세한 내용을 안내하려면 세부 정보 단추를 사용합니다.
  • 문제의 솔루션에 대한 자세한 내용을 안내하려면 도움말 단추를 사용합니다.
  • 메시지에 사용자 작업이 포함된 경우 확인 단추를 사용하여 메시지 상자를 닫습니다.
  • 예 및 아니요 단추는 조합하여 사용해야 하며 항상 질문 앞에 와야 합니다.
• 오류가 심각한 경우 이벤트 로그에 씁니다.

스타일 고려 사항

• 완전하면서도 간단한 문장을 사용합니다.
• 현재 시제를 사용하여 문제를 일으킨 조건 또는 여전히 존재하는 상태를 설명합니다. 이전에 발생한 고유 이벤트를 설명할 때는 과거 시제를 사용할 수 있습니다.
• 가능하면 능동태를 사용합니다. 오류 조건을 설명할 때는 수동태를 사용할 수 있습니다.
• 대문자 텍스트 및 느낌표를 사용하지 않습니다.
• 사용자의 실수로 문제가 발생했더라도 사용자가 잘못했다고 느끼지 않도록 합니다.
• 의인화하지 않습니다. 프로그램 또는 하드웨어가 생각하거나 느낄 수 있는 것처럼 암시하지 마세요.
• 구어체 단어나 구를 사용하지 않습니다. 특정 문화권에서 불쾌할 수 있는 용어를 사용하지 마세요.
• 의미를 명확히 하기 위해 전치사 또는 하위 절을 추가하지 않고 명사들만 나열하지 않습니다. 예를 들어 "사이트 서버 LDAP 서비스 디렉터리 서버"는 "사이트 서버의 LDAP 서비스에 대한 디렉터리 서버"로 변경하세요.
• 용어 앞에 설명자를 삽입하여 문장의 의미를 명확히 합니다. 예를 들어 "검색이 아니요로 설정된 경우 InfID 지정"을 "검색 옵션이 아니요로 설정된 경우 InfID 매개 변수 지정"으로 변경하세요.
• "잘못된"이라는 단어를 사용하지 않습니다. 더 자세히 설명하는 용어로 무엇이 잘못되었는지 사용자에게 안내합니다. 예를 들어 "잘못된 크기"와 같은 메시지를 사용하지 않습니다. 대신 크기를 지정할 때 사용할 기준을 사용자에게 알려주세요.
• "해주세요"라는 단어를 사용하지 않습니다. 필수 작업이 선택 사항으로 해석될 수 있습니다.
• 인덱스에 있고 핵심과 관련된 단어를 메시지 문자열의 처음에 배치합니다.