Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revise all error messages adopting usability pattern #1019

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from

Conversation

emmanueleclipse
Copy link

@emmanueleclipse emmanueleclipse commented Jul 8, 2024

### Changes Made:

  • Switched to clearer explanations: Updated error messages to explicitly state what went wrong and why.
  • Used empathy and politeness: Maintained a polite and empathetic tone.
  • Added actionable guidance: Included specific instructions on how users can resolve issues or contact support.
  • Reduced technical jargon and blame: Reduced technical language and avoided blaming users or third parties.
    Note: Currently using “#” in place for a link to contact customer support

@emmanueleclipse emmanueleclipse marked this pull request as draft July 9, 2024 00:44
@emmanueleclipse emmanueleclipse marked this pull request as ready for review July 9, 2024 00:46
@aslesarenko aslesarenko linked an issue Jul 16, 2024 that may be closed by this pull request
case _ => sys.error("Unsupported scala version")
case _ => sys.error("The Scala version you are using is not supported. " +
"Please use one of the supported versions: Scala 2.11, 2.12, or 2.13. " +
"If the issue keeps happening, contact <a href=\"#\">Customer care</a>.")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. for the "Help them fix it" part, an instruction of which SBT variable should be checked for the current version.
  2. Also there is no "Customer care", only Discord channels. (this also applies to all the other messages)

case _ => sys.error(s"Collection value $c has unexpected type $tpe")
case _ => sys.error(s"The value in the collection $c is not the correct type: $tpe. " +
"Please make sure the value is of the correct type. " +
"If the issue keeps happening, contact <a href=\"#\">Customer care</a>.")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The meaning of the message has been changed, which makes it less clear (despite many more words).
Please see how the method is used to come up with a clarifying message.

@satsen
Copy link

satsen commented Nov 2, 2024

this should be closed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Revise all error messages adopting usability pattern
3 participants