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

Better term and explantion for issues #975

Open
dgdavid opened this issue Jan 2, 2024 · 1 comment
Open

Better term and explantion for issues #975

dgdavid opened this issue Jan 2, 2024 · 1 comment

Comments

@dgdavid
Copy link
Contributor

dgdavid commented Jan 2, 2024

We have two kind of issues:

  • errors, which does not allow continuing with the installation
  • issues, which allows the user to continue with the installation because they are more "potential problems" or even "recommendations"

In the confirmation dialog shown just before starting the installation, Agama is encouraging the users to review the issues just in case they've overlooked them. But we need to improve both, the term and the explanation without linking the latest to the UI look&feel.

Read #886 (comment) to know more.

@shundhammer
Copy link

Some clarification from my side:

I noticed that we are expecting the user to understand a very high level of English, but we know that a lot of them are using the English version not completely voluntarily, and they might not speak English as well as we expect.

They might have to use English because there is no translated version available in their language, or they might be in an international environment having to cooperate with others who understand completely different languages, so often English is the only common denominator. Also, when you have to Google or use Internet forums for problem solutions, you are much better off using an English error message.

So we should take great care to keep our messages understandable for non-native English speakers.

Also, we should avoid messages that are too generic and using our internal lingo too much; the messages should help the users, not confuse them.

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

No branches or pull requests

2 participants