코드만 보이는 화면은 이용자를 멈춰 세웁니다
양식을 제출했는데 알파벳과 숫자로 된 코드만 나타나면 이용자는 다시 시도해야 하는지, 입력을 고쳐야 하는지, 기다려야 하는지 알 수 없습니다. 내부 코드는 담당자가 원인을 찾을 때 도움이 되지만, 화면을 보는 사람에게 전부인 안내가 되어서는 안 됩니다. 오류 메시지가 해야 할 일은 문제가 어디서 생겼는지 알리고, 지금 할 수 있는 행동을 한 가지 이상 보여 주는 것입니다. 이 두 가지가 빠진 메시지는 안내가 아니라 알림에 불과합니다.
문구를 점검할 때는 "그래서 지금 무엇을 해야 하나요"라는 질문에 답이 있는지 소리 내어 읽어 봅니다. 답이 없다면 행동 문장을 하나 더 넣습니다.
입력 오류와 서비스 문제는 말투부터 다르게 씁니다
필수 항목이 비어 있거나 형식이 맞지 않는 경우는 이용자가 바로 고칠 수 있습니다. 이때는 어떤 칸이 문제인지 표시하고, 이미 입력한 다른 값은 그대로 유지해 처음부터 다시 쓰지 않게 합니다. 반면 서버나 외부 인증처럼 이용자의 잘못이 아닌 경우에는 이용자가 잘못한 것처럼 읽히지 않도록 표현합니다. 잠시 뒤 다시 시도하거나 공식 지원 경로를 이용하도록 안내하고, 확인되지 않은 복구 시간은 약속하지 않습니다.
입력 안내에는 예시를 한 가지 함께 보여 주면 이용자가 형식을 바로 이해합니다. 오류가 난 뒤에야 알려 주기보다 입력 전에 형식을 안내하는 것이 더 좋은 설계입니다.
오류 문구는 이용자가 읽는 시간이 짧다는 점을 고려해 두세 문장 이내로 쓰고, 긴 설명이 필요하면 자세히 보기 형태로 나누어 제공합니다.
예약과 결제에서는 완료 여부가 가장 중요한 정보입니다
중요한 행동에서 오류 화면이 나타났다고 해서 처리가 실제로 접수되지 않았다고 단정할 수는 없습니다. 이런 상황에서 묻지 않고 다시 제출하라고 안내하면 같은 신청이 중복되는 문제가 생길 수 있습니다. 현재 상태를 확인할 수 있는 경로를 함께 제공하고, 운영자가 추가로 확인해야 한다면 어떤 정보가 필요한지를 최소 범위로 안내합니다. 개인 정보를 공개 댓글이나 게시판에 남기도록 유도하는 안내는 하지 않습니다.
접수가 되었는지 확인하는 화면이 따로 있다면 오류 안내에서 그 위치를 직접 연결합니다. 이용자가 메뉴를 찾아 헤매는 사이 다시 제출하는 일이 줄어듭니다.
메시지가 나타나는 위치도 설계의 일부입니다
화면 맨 위에는 "오류가 발생했습니다"만 보이고 문제가 있는 입력란은 아래쪽에 숨어 있으면 찾는 데 시간이 걸립니다. 해당 항목 가까이에 원인과 해결 방법을 함께 표시하는 편이 좋습니다. 키보드로 이동하는 사용자와 화면 낭독 도구를 쓰는 사용자도 오류를 인지할 수 있는지 확인해야 합니다. 빨간색 같은 색상만으로 상태를 구분하지 않고, 글자나 아이콘으로도 의미를 전달합니다.
오류가 여러 개일 때는 첫 번째 문제 칸으로 초점을 옮기고 전체 목록도 요약해서 보여 주면 수정 속도가 빨라집니다.
이용자에게 보이는 문구와 내부 기록은 나눕니다
고객 화면에는 쉬운 말로 된 설명을 보여 주고, 내부 코드와 발생 시각은 지원 담당자가 추적할 수 있게 별도로 보관합니다. 민감한 시스템 정보는 공개 화면에 노출하지 않습니다. 문의가 필요할 때를 대비해 접수 번호처럼 개인 정보가 아닌 식별 값을 보여 주는 방법도 있습니다. 이용자에게 화면 전체를 캡처하거나 입력한 민감한 값을 알려 달라고 요구하는 방식은 피하는 것이 안전합니다.
내부 기록에는 발생 시각과 화면 이름을 함께 남겨 두면 지원 담당자가 문의를 받았을 때 원인을 빠르게 좁힐 수 있습니다.
문구를 바꾸기 전에 반복되는 원인부터 고칩니다
같은 오류가 계속 나타난다면 문구를 더 친절하게 바꾸는 것만으로는 충분하지 않습니다. 원인을 찾아 고치는 것이 우선이며, 문구는 그 사이 이용자의 부담을 줄이는 보조 수단입니다. 배포 전에는 모바일과 컴퓨터에서 실제로 오류 상황을 만들어 보고, 메시지가 시스템의 실제 동작과 일치하는지 시험합니다. 좋은 오류 메시지는 코드를 해독하라고 요구하지 않고 이용자가 자신의 작업 상태를 이해해 안전한 다음 단계를 선택하게 돕습니다.
오류 문구 목록을 한 문서에 모아 두고 담당자와 마지막 점검일을 적어 두면, 시스템이 바뀔 때 어떤 문구를 같이 고쳐야 하는지 놓치지 않습니다.