search

agama-project / agama

A service-based Linux installer
https://agama-project.github.io/
GNU General Public License v2.0
143 stars 43 forks source link

Better term and explantion for issues #975

Closed dgdavid closed 5 months ago

dgdavid commented 10 months ago

We have two kind of issues:

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 https://github.com/openSUSE/agama/pull/886#discussion_r1437545715 to know more.

shundhammer commented 10 months ago

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.

dgdavid commented 5 months ago

I think this is kind of obsoleted by changes done at #1202. Let's close it by now. We can re-open it later if still relevant.