오류 메시지

오류 메시지

사용자는 일반적으로 무언가를 수행하려고 시도했지만, 뭔가가 제대로 되지 않아 계속할 수 없을 때 오류 메시지를 보게 돼요. 이 가이드에서는 명확하고 실행 가능하며 공감적인 오류 메시지를 작성하는 방법을 다룹니다.

출처: Error Messages

본문

오류 메시지 구조

오류 메시지는 간결하면서도 서술적이어야 해요. 유용한 패턴으로 설명(description)·이유(reason)·해결책(resolution)을 포함하는 것을 따라보세요:

• 설명(Description): 무슨 일이 있었나?
  • 예를 들어, 사용자의 로그인이 실패했을 때.
• 이유(Reason): 왜 일어났나?
  • 예를 들어, SSH 키가 자동 로그인을 허용하지 않을 때.
• 해결책(Resolution): 어떻게 해결할 수 있나?
  • 예를 들어, 사용자가 호스트에 수동으로 로그인해야 할 수 있어요.

설명·이유·해결책을 제목과 결합해 강력한 오류 메시지를 만드세요. 예를 들어:

• 설명: Login failed
• 이유: The SSH key for auto-login is either not available, is unauthorized, or is password protected.
• 해결책: To manually log in to the host, click Log in.

오류 메시지 작성 모범 사례

오류 메시지를 만들 때 다음 모범 사례를 명심하세요:

사용자를 탓하지 마세요

사용자가 오류가 자신의 잘못이라고 느끼게 해서는 안 돼요. "You did something wrong" 같은 언어를 피하세요. 메시지에 따라 사용자에게 책임을 돌리지 않도록 능동태 대신 수동태를 써야 할 수도 있어요.

사용자에게 다음 단계를 주세요

사용자가 막혔다고 느끼게 해서는 안 돼요. 오류에 부딪히면, 작업을 계속하는 데 필요한 정보를 주세요.

전문 용어 피하기

오류 메시지는 사용자가 이해하지 못할 수 있는 기술 용어 없이도 충분히 좌절스러워요. 전문 용어를 피하고 사용자에게 익숙한 용어를 사용하세요.

적절한 양의 설명을 포함하세요

무엇이 잘못됐는지 사용자에게 말하세요. 설명 없는 오류는 좌절감을 더하고 해결책을 찾는 것을 방해할 수 있어요.

하지만 너무 많은 정보를 포함하지 마세요. 사용자는 백그라운드에서 정확히 무슨 일이 일어나는지 알 필요가 없어요. 무엇이 잘못됐고 그다음 무엇을 할 수 있는지에 대한 정보만 주세요.

혜택으로 시작하세요

사용자에게 해결책을 제공할 때는 목표("혜택")로 문장을 시작하고, 이어서 계속하기 위해 해야 할 일을 제시하세요.

404 오류 페이지

404 페이지는 사용자가 보려는 콘텐츠가 존재하지 않거나 찾을 수 없을 때 도달하는 오류 페이지예요. 404 페이지는 전달하는 오류 유형의 이름을 따서 명명됩니다: "Error 404: Not found."

오류 메시지 모범 사례를 염두에 두고 404 페이지를 작성하세요: 404 오류가 무엇인지 설명하고, 사용자가 어떻게 진행할 수 있는지 정의하며, 거기에 도달하는 데 필요한 도구를 제공하세요.

효과적인 404 페이지는 길을 잃은 사용자가 원하는 목적지에 도달하거나 새 목적지를 찾도록 재정비·리디렉션·역량 강화하기 위해 여러 요소를 결합해요.

• 제목(Heading): 404 오류가 무엇인지 사용자가 이해할 수 있는 평이한 언어로 전달해요. 명확히 정의되지 않았다면 "404"나 "404 error"를 포함하지 마세요: "404: That page no longer exists." 구두점 없는 페이지 제목이 브랜드나 제품과 일치하지 않는 한, 404 제목을 끝 구두점(마침표) 없이 작성하세요.
• 다음 단계(Next steps): 사용자가 사이트를 검색하거나 추천 콘텐츠를 탐색하도록 초대해 진행 방법을 정의해요. 항상 다음 단계를 완전한 문장으로 쓰고 그에 따라 구두점을 붙이세요.
• 추천 콘텐츠(선택): 온보딩 정보·참조 가이드·FAQ 같은 관련 페이지를 가리켜요.
• 홈페이지 링크: 사용자가 사이트의 홈페이지로 빠르고 쉽게 돌아갈 수 있는 방법을 제공해요.

404 오류 콘텐츠 모범 사례

404 페이지를 막다른 길이 아니라 비행 경로로 생각하세요. 명확하고 유익한 마이크로카피를 사용해 사용자를 올바른 방향으로 안내하세요. 예시를 보려면 PatternFly의 404 페이지를 방문하세요.

효과적인 404 페이지를 만들려면 다음 모범 사례 가이드라인을 따르세요:

• 이해 가능한 언어를 사용하세요. 404 제목을 평이하고 구체적인 용어로 작성해 기술 전문 용어를 건너뛰세요.

• 느낌표·구어체·과도한 유머를 피하세요. 404 제목을 유익하고 반복 가능하게 작성하세요. 사용자가 페이지에 두 번 이상 도달하면 농담은 식상해져요. "Uh oh!"나 "Oops!" 같은 불필요한 단어를 피하세요.

• 사용자에게 책임을 돌리지 마세요. 브랜드가 1인칭 복수("we") 대명사를 사용하지 않는다면, 제목의 주어로 "that page"나 "this page"를 사용하세요.

• 오류를 기회로 바꾸세요. 항상 사이트 홈페이지로 돌아가는 링크를 제공하고, 제목 아래에 보충 다음 단계를 포함해 사용자가 왔던 곳으로 그냥 돌아가는 것 너머의 옵션을 탐색하도록 장려하세요.

• 브랜드 목소리를 담으세요. 지루하고 비인격적인 오류 메시지는 좌절감을 줄 수 있어요. 더 매력적인 사이트 경험을 지원하기 위해 404 페이지 콘텐츠에 브랜드 개성을 더하세요.

• 모든 사용자를 위해 쓰세요. 현지화에 유의하세요. 말장난·언어유희·문화적 참조는 모든 사용자에게 현지화되지 않을 수 있어요. 재치보다 명확성을 우선시하세요.

더 알아보기 (Learn more)

• Content Design Overview
• Product tours