테크니컬 커뮤니케이션 · COM-14

견적서를 다시 올려도 오류만 나왔다

가상 이야기 · 핵심노트 기반

핵심노트 개념: 오류 안내 — 원인보다 다음 행동부터 돕는다

이 글에서 배우는 교훈

오류 안내는 확인된 실패 조건과 사용자의 다음 행동, 입력·처리 상태를 구체적으로 알려야 합니다.

핵심노트를 바탕으로 만든 가상 이야기입니다. 실제 사건이나 검증된 성과가 아닙니다.
근거: 오류 안내 — 원인보다 다음 행동부터 돕는다 · 핵심노트 14

구체적으로는 파일의 현재 크기와 허용 크기, 수정 방법과 입력 보존 여부를 안내해 의미 없는 재업로드를 줄였습니다.

관련 교재 내용

프로젝트관리 및 테크니컬커뮤니케이션 · IV. 테크니컬 문서 · 문제 증상과 해결 방법

교재의 설명서는 문제의 증상과 해결 방법을 제공하도록 구성됩니다.

이 사례에 적용한 내용: 파일의 현재 크기와 허용 크기, 수정 방법과 입력 보존 여부를 안내해 의미 없는 재업로드를 줄였습니다.

교재 54쪽 확인 →

교재 원리의 실무 적용 · 교재 원문 인용이 아닌 자체 설명입니다.

본문

고객은 18MB 견적서를 제출하다 오류라는 안내를 받았습니다. 네트워크 문제로 생각해 같은 파일을 세 번 올렸지만 모두 실패했습니다. 실제 원인은 파일 한도가 10MB라는 것이었고 그 한도는 실패 화면에 보이지 않았습니다.

팀은 ‘파일은 10MB까지 올릴 수 있습니다. 현재 파일은 18MB입니다. 용량을 줄여 다시 선택하세요. 작성한 내용은 유지됩니다’라고 안내했습니다. 실제 입력 보존도 확인하고, 연결 오류처럼 원인이 다른 경우에는 같은 크기 안내를 쓰지 않도록 구분했습니다.

결론

오류를 친절하게 표현하는 것만으로는 부족했습니다. 사용자가 무엇을 고치면 다음 단계로 갈 수 있는지, 어떤 내용이 이미 저장됐는지 정확히 알려 줘야 재시도를 줄일 수 있습니다.