더 나은 에러 메시지를 써 보자

작성 : 2023-01-12수정 : 2023-01-12

목차 펼치기

4H

  • Human | 인간적

  • Helpful | 도움

  • Humorous | 유머러스

  • Humble | 겸손


Wrong

  • 부적절한 어조 사용

    → 유저에게 에러에 대해 진지하게, 그들의 문제를 이해하고 있다는 듯이 전달해야 한다.

  • 전문용어 사용

    → 단지 무엇이 잘못되었고, 어떻게 고칠 수 있는 지를 알려준다.

  • 책임 전가

    → 유저의 액션에 책임을 전가하지말고, 서비스의 전문성을 지키기 위해 서비스 자체의 문제로 보이지 않도록

  • 이유 없이 일반적인 액션만 명령

    → 에러의 원인을 제공할 수 있으면 제공하자.

  • 포괄적인 메시지

    • 무언가 잘못되었다는 것 외에 다른 정보를 포함하고 있지 않다.

    • “오류가 발생하여 이 작업을 완료할 수 없습니다.”

  • 불분명한 메시지

    • 문제 원인을 설명하려고 했으나, 혼란스러운 언어 사용으로 인해 사용자가 이해하기 불분명해짐

    • “요청 권한을 허용한 뒤 다시 시도하세요.”



Right

  • 무슨 문제가, 왜 생겼는지

    → 오류가 발생한 이유를 명확히 설명하기.

  • 안심할 수 있게

    → 가능하다면 에러에 영향을 받지 않은 처리에 대해 알려주기.

  • 공감

    → 부탁하는 어휘 사용

  • 유저가 문제를 해결할 수 있도록 돕기

    → 해결 또는 대응 방법 제공하기. 공간이 제약될 경우 문제 설명 링크가 포함된 URL로 안내

  • 빠져나갈 길 제공

    → 문제가 계속 발생할 여지가 있다면, 고객센터로 연결하는 경로 제공




참고

https://story.pxd.co.kr/1128https://brunch.co.kr/@libroamore/18

Contact Me

All Icons byiconiFy