안내문은 모든 것이 정상일 때보다 예상과 다른 일이 생겼을 때 더 중요합니다. 독자는 긴 설명보다 지금 자신의 상태가 무엇이고 안전하게 무엇을 해야 하는지 먼저 찾습니다.
작성자는 절차를 처음부터 끝까지 설명하고 싶지만 독자는 이미 중간에 들어와 있을 수 있습니다. 결제는 됐는데 권한이 없거나, 링크는 만료됐거나, 본인에게 필요한 조건만 다른 상황이 대표적입니다.
좋은 안내는 정보를 많이 넣는 문서가 아니라 상태를 구분하고 선택의 결과를 미리 보여주는 인터페이스입니다. 기본 흐름과 예외 흐름을 함께 설계하고 실제 질문으로 찾을 수 있는 표현을 사용해야 합니다.
독자가 도착한 장면을 먼저 세 갈래로 나눕니다
처음 시작하는 사람, 진행 중 막힌 사람, 완료 뒤 결과가 예상과 다른 사람은 필요한 답이 다릅니다. 하나의 긴 순서에 모두 넣지 말고 첫 화면에서 자신의 상태를 고르게 합니다.
내부 부서명이나 시스템 상태 코드 대신 독자가 실제로 말할 문장을 제목으로 씁니다. ‘권한 동기화 지연’보다 ‘결제했는데 콘텐츠가 열리지 않아요’가 더 빨리 발견됩니다.
바로 써보기시작 전 / 진행 중 멈춤 / 완료 후 문제. 각 갈래 아래에 가장 많은 질문을 독자의 말로 배치.
해야 할 행동 앞에 결과와 조건을 보여줍니다
버튼을 누르거나 정보를 제출하기 전에 무엇이 바뀌고 되돌릴 수 있는지 알려야 합니다. 특히 삭제, 해지, 공개 범위 변경처럼 영향이 큰 행동은 결과를 행동 뒤에 숨기지 않습니다.
조건이 많은 경우 문장 안에 모두 넣지 말고 ‘가능한 경우’와 ‘불가능한 경우’를 나눕니다. 예외를 각주로 보내면 가장 필요한 사람이 놓칠 수 있습니다.
오류 메시지는 원인 추측보다 복구 순서를 줍니다
시스템이 확실히 알지 못하는 원인을 단정하지 않습니다. 현재 확인된 상태, 사용자가 먼저 해볼 행동, 해결되지 않을 때 필요한 정보와 문의 경로를 순서대로 제공합니다.
‘다시 시도하세요’만 반복하지 말고 언제 다시 시도할지, 몇 번 뒤에는 멈춰야 하는지, 중복 실행 시 위험이 있는지를 알려야 합니다. 결제나 데이터 변경은 특히 안전한 중단 지점이 필요합니다.
바로 써보기현재 상태 → 안전한 첫 조치 → 결과 확인 → 해결되지 않을 때 보낼 정보 → 지원 경로
정책 문장과 실제 선택 화면의 표현을 맞춥니다
도움말에서는 ‘구독 종료’, 버튼에서는 ‘멤버십 해제’, 이메일에서는 ‘자동 결제 중지’라고 쓰면 같은 행동인지 다시 판단해야 합니다. 핵심 명칭과 상태를 하나의 용어표로 관리하세요.
법적 정확성이 필요한 문장은 그대로 두되 바로 아래에 사용자가 이해할 수 있는 요약과 예시를 제공합니다. 요약이 원문의 범위를 바꾸지 않는지도 담당자가 검수해야 합니다.
문의 검색어와 실패 기록으로 안내문을 고칩니다
작성자가 생각한 목차보다 실제 검색어, 페이지에서 반복된 이탈, 상담에 들어온 표현을 봅니다. 답이 있는데도 문의가 계속되면 내용이 없는 것이 아니라 제목·위치·표현이 발견되지 않는 문제일 수 있습니다.
수정 뒤에는 같은 질문의 문의량만 보지 말고 사용자가 스스로 해결한 비율, 잘못된 행동의 감소, 지원까지 걸린 단계도 확인합니다. 안내문의 완료 기준은 발행이 아니라 복구 가능성입니다.
SAVE & CHECK
이번 주 실행 체크리스트
- 처음 시작·진행 중 멈춤·완료 후 문제를 서로 다른 경로로 나눴다.
- 제목이 내부 용어가 아니라 독자가 실제로 묻는 문장에 가깝다.
- 영향이 큰 행동 전에 결과·조건·되돌리는 방법을 알린다.
- 오류 원인을 추측하지 않고 확인된 상태와 복구 순서를 제공한다.
- 중복 실행 위험이 있을 때 안전한 중단 지점이 명확하다.
- 정책·버튼·이메일에서 핵심 용어가 일관된다.
- 검색어·문의·이탈 기록으로 수정 효과를 확인한다.
안내문은 정상 흐름을 설명하는 문서가 아니라, 막힌 사람이 안전하게 다음 선택을 하도록 돕는 길찾기입니다.
오늘의 한 가지안내문은 정상 흐름을 설명하는 문서가 아니라, 막힌 사람이 안전하게 다음 선택을 하도록 돕는 길찾기입니다.기억하고 싶은 문장을 남겨두고, 아래에서 당신의 생각도 들려주세요.
댓글
0아직 댓글이 없습니다. 콘텐츠에서 떠오른 생각을 나눠보세요.