Add translation.md for Weblate.org #29447
Conversation
|
Thanks for the PR. Could you link an issue to the PR so that we can track this one? Please also make sure to link any previous discussion in said issue. |
| Thank you for your interest in contributing translations to Keycloak! Translations play a crucial role in making Keycloak accessible to users from diverse linguistic backgrounds. This document provides guidelines for contributing translations and getting started with Weblate. | ||
|
|
||
| ## Why Translation Matters | ||
| Translation enables Keycloak to reach a wider audience by making the platform usable for speakers of various languages. By translating Keycloak, you help improve accessibility and usability for users who may not be proficient in English. |
There was a problem hiding this comment.
Not sure if we need this paragraph, as it's kinda already covered by the previous one:
Translations play a crucial role in making Keycloak accessible to users from diverse linguistic background.
Perhaps roll these up into one paragraph?
There was a problem hiding this comment.
I'm a fan of a heading that explains the "why", so I tend to keep it. I removed one sentence from the first paragraph. Let me know what you think.
Co-authored-by: Jon Koops <jonkoops@gmail.com>
Co-authored-by: Jon Koops <jonkoops@gmail.com>
Co-authored-by: Jon Koops <jonkoops@gmail.com>
Co-authored-by: Jon Koops <jonkoops@gmail.com>
Signed-off-by: Alexander Schwartz <aschwart@redhat.com>
|
@robson90 - I pushed some changes. The major change is that I updated "language" with "translation", and then removed English from the list, as that is not a translation, but the source. IMHO only those translations are in scope for this document, and not the source language. |
@ahus1 Im fine with he changes, thanks for taking this over! 🎉 Could you please check if it is possible to disable the language request on Weblate ? Then we have only one point of interaction. |
Co-authored-by: Robin Meese <39960884+robson90@users.noreply.github.com>
I found that I can switch in each component, in the settings on the tab "Files", I can choose for "Add new translation" the option "Point to translation instructions URL". Once this PR is then merged, we can update the "Translation instructions" in the settings for the Weblate Keycloak project to this new translation.md file. |
|
@jonkoops - could you please re-review the latest changes if you are ok to merge this PR as a first version? Once it is merged, I'll update the translation instructions to point to the new file. Once that is in place, IMHO we are ready to add one more language. |
|
|
||
| Keycloak welcomes translations of its user interfaces and error messages via Weblate. | ||
|
|
||
| There is also a [Keycloak Documentation translation project](https://github.com/openstandia/keycloak-documentation-i18n). |
There was a problem hiding this comment.
Perhaps good to mention that this is not maintained by the Keycloak team itself, but a third party.
|
|
||
| Please note that while we aspire to support more translations in the future, our current focus is on these translations. We rely on volunteers like you to take the initiative in steering the translation efforts for additional translations. If you're interested in contributing translations for a language not listed above, add a comment to the [localization platform discussion](https://github.com/keycloak/keycloak/discussions/9270). | ||
|
|
||
| If you have any questions or need assistance, feel free to reach out to the language maintainers listed below: |
There was a problem hiding this comment.
Perhaps we could also create a nomination proccess here, if someone wants to volunteer to be a maintainer for the translations of a specific language on Weblate, we can ask them to open a PR to add a new language here and add their name as a maintainer. WDYT?
There was a problem hiding this comment.
Sounds like a follow-up PR to me. For the time being, the "If you're interested in contributing translations for a language not listed above, add a comment" should work.
There was a problem hiding this comment.
Perhaps we should link this document from the contribution guide as well, so that folks end up here when they are looking to contribute.
There was a problem hiding this comment.
Yes - this is the next step as discussed with @robson90
|
Thank you for everyone who contributed. This is now linked in the project description on Weblate: https://hosted.weblate.org/projects/keycloak/#information |
Closes #29548