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

Fix typos in the English version #4802

Merged
merged 9 commits into from
Jun 1, 2022
Merged

Fix typos in the English version #4802

merged 9 commits into from
Jun 1, 2022

Conversation

javierm
Copy link
Member

@javierm javierm commented Apr 1, 2022

References

Objectives

  • Make some texts easier to understand by people who can read English 😉

@javierm javierm added the Bug label Apr 1, 2022
@javierm javierm added this to Reviewing in Consul Democracy via automation Apr 1, 2022
@javierm javierm self-assigned this Apr 1, 2022
@javierm javierm moved this from Reviewing to Doing in Consul Democracy Apr 1, 2022
@javierm javierm mentioned this pull request Apr 1, 2022
@javierm javierm force-pushed the typos branch 2 times, most recently from a860e7b to 4d1b6ec Compare April 1, 2022 16:24
@javierm javierm force-pushed the typos branch 2 times, most recently from 935a25e to ad7136f Compare May 5, 2022 14:58
@javierm javierm marked this pull request as ready for review May 5, 2022 14:58
@javierm javierm moved this from Doing to Reviewing in Consul Democracy May 5, 2022
@Senen Senen self-assigned this Jun 1, 2022
Consul Democracy automation moved this from Reviewing to Testing Jun 1, 2022
As suggested by Pomerange; the "help about" construction indeed sounds a
bit strange.
We used "retire" because we translated it literally from the Spanish
verb "retirar" which can mean both "retire" and "withdraw".

Note we're still using "retire" in database fields and method names;
changing that might make it harder to upgrade from a previous version of
CONSUL.
In English, circumstancial complements usually go after the direct
complement.
As suggested by Pomerange; "proposals" sounded strange as an adjective.
As suggested by Pomerange, "credentials" also refers to academic
qualifications, and so might be confusing.
We were saying that actions marked with an asterisk were only possible
when users were verified. However, there were no actions marked with an
asterisk; instead, we didn't show these actions to non-verified users.

Besides, the concept of Census doesn't exist in many CONSUL
installations, where verification is done through other means, so the
text saying that only users on Census could do certain things wasn't
correct in these cases.

Due to that, we're removing the asterisk in the Spanish version as well.
We're also removing the asterisk in the default welcome pages, since
we're already saying which action can't be done until the account is
verified.

In the case of the residence verification page, we had asterisks but we
didn't explain what the asterisk stood for, so we're also removing it.
We had the same texts four times, with slight variations in the case of
the management section.

We're unifying them under the "verification" i18n namespace, since the
texts are about actions which can be done depending on whether users are
verified or not.

Note the names of the i18n keys aren't very consistent, since we use
"debates" in plural but "proposal" in singular. We're leaving it like
this so existing translations aren't affected.
"Participate in the final voting" was a concept which was hard to
understand since many people would think it was related to the
voting/polls section and that somehow there was going to be a "final"
poll.

So we use "Vote for budget projects" instead.

Thanks Pomerange for the suggestion.
@javierm javierm merged commit 5c31792 into master Jun 1, 2022
Consul Democracy automation moved this from Testing to Release 1.5.0 Jun 1, 2022
@javierm javierm deleted the typos branch June 1, 2022 12:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Demo: improving English
3 participants