도움말 분기 설계, 확인 결과에 따라 다음 행동을 연결하기
기준일 2026-10-21 · AZET 운영팀 작성
AZET 운영팀이 작성한 문제 해결 도움말의 참고용 구성안입니다. 파일 다운로드에 관한 아래 선택 경로는 가상의 문서 예시이며, 특정 제품의 오류 원인이나 해결 기능을 설명하는 내용은 아닙니다.
자주 묻는 질문 목록에서는 독자가 자기 상황에 맞는 제목을 찾습니다. 문제 해결용 도움말은 확인한 답에 따라 다음 질문이나 행동을 제시합니다. 따라서 질문의 수보다 갈림길의 기준이 명확한지, 어느 경로에서도 막다른 곳에 이르지 않는지가 중요합니다.
원인 이름 대신 눈에 보이는 상태를 묻습니다
첫 질문에 ‘권한 오류인가요?’라고 적으면 사용자가 진단부터 해야 합니다. ‘접근할 수 없다는 문구가 표시되나요?’처럼 실제로 볼 수 있는 상태를 묻는 편이 답하기 쉽습니다. 한 질문에서는 하나의 조건만 확인하고, 예와 아니오의 의미가 겹치지 않게 씁니다.
다운로드 문제라면 파일이 만들어지지 않은 상태와 받은 파일을 열지 못하는 상태를 먼저 나눌 수 있습니다. 시작부터 브라우저 설정 변경을 제시하면 관련 없는 사람도 작업을 수행하게 됩니다.
| 확인 질문 | 답에 따른 이동 | 분기 설계의 목적 |
|---|---|---|
| 다운로드 목록에 파일이 있나요 | 있음: 파일 확인 / 없음: 화면 상태 확인 | 저장 전후 구분 |
| 받은 파일이 비어 있나요 | 예: 내용 확인 경로 / 아니오: 열기 문제 경로 | 서로 다른 증상 분리 |
| 화면에 안내 문구가 있나요 | 있음: 문구별 안내 / 없음: 지원 접수 | 다음 진단 단서 확보 |
| 현재 상태를 확인할 수 있나요 | 어려움: 확인 방법 / 해당 없음: 다른 증상 선택 | 추측 선택 방지 |
위 표의 경로는 구조 설명용입니다. 실제 문서에서는 각 도착점에 구체적인 확인 방법이나 지원 경로가 있어야 합니다. ‘다른 방법을 시도하세요’라는 문장으로 끝내면 분기만 있고 해결 절차는 없는 셈입니다.
조치 뒤에는 결과를 확인하는 질문을 둡니다
한 단계에서 여러 설정을 한꺼번에 바꾸게 하면 무엇이 영향을 줬는지 알기 어렵습니다. 적용 가능한 조건과 조치를 짧게 설명한 뒤 결과를 확인하게 합니다. 정상으로 돌아왔을 때 무엇이 보여야 하는지도 함께 적어야 사용자가 종료 여부를 판단할 수 있습니다.
조치가 자료 삭제나 접근 권한 변경을 포함한다면 영향과 되돌릴 방법을 먼저 설명합니다. 권한이 없는 사람에게 관리자 메뉴를 찾게 하기보다 담당자에게 넘기는 갈래를 둡니다.
‘모름’을 선택하면 같은 질문으로 되돌리지 않습니다. 상태를 확인하는 짧은 설명을 보여 주거나, 확인 없이도 전달할 수 있는 정보를 모아 지원으로 연결합니다. 이전 답을 바꿀 때는 처음부터 전부 입력하게 하지 말고 관련 갈림길로 돌아갈 수 있게 설계합니다.
배포 전에는 모든 끝점을 따라가 봅니다
각 경로가 해결 확인, 조건에 맞는 대기, 지원 전환 중 어디로 끝나는지 표시합니다. 앞의 질문으로 계속 돌아가는 순환이 없는지 점검하고, 갈림길이 너무 많다면 업무 장면별로 입구를 나눕니다.
지원으로 전환될 때는 고른 답과 이미 시도한 조치를 요약하게 합니다. 처음부터 같은 질문을 반복하지 않도록 돕는 정보입니다. 문서를 고친 뒤에는 이전 경로에 남은 버튼명과 조건도 검토합니다.
자주 묻는 질문(FAQ)
Q1. 질문마다 예와 아니오만 두면 되나요? 상태를 알 수 없거나 질문이 해당하지 않는 경우가 있습니다. 억지로 답을 고르지 않도록 별도의 출구를 마련합니다.
Q2. 몇 단계가 적당한가요? 정해진 숫자보다 각 질문이 필요한지를 봅니다. 답이 달라도 같은 안내로 이동한다면 질문을 합치거나 빼는 것을 검토합니다.
AZET 관련 안내는 azet.io에서 확인하세요.