Skip to content

Commit daf7d0d

Browse files
authored
Update contributing-translations.md
Using our combined super powers, add information from @mauritsvanrees and @erral to clarify the process.
1 parent 761f033 commit daf7d0d

File tree

1 file changed

+19
-5
lines changed

1 file changed

+19
-5
lines changed

docs/i18n-l10n/contributing-translations.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -82,22 +82,36 @@ The process of translating the Volto frontend is the following.
8282
## Weblate for translations
8383

8484
[Weblate](https://weblate.org/) is an open source project to help software developers translate their projects.
85-
8685
Translators can work in a web interface, and not have to install third-party software or use git or GitHub.
87-
8886
The Plone Foundation has obtained a "gratis Libre plan" account for Plone.
8987
Plone gets free hosting at the [Hosted](https://hosted.weblate.org/) platform that Weblate offers to open source projects.
9088

91-
Translators can go to the [Plone project in Weblate](https://hosted.weblate.org/projects/plone/) to write translations.
9289

93-
Translators will need to create an account there.
94-
Then your translations will be automatically contributed back to Plone's GitHub repository.
90+
### Weblate workflow
91+
92+
Translators will need to create an account on Weblate with an email and password.
93+
Authentication with GitHub and other third-party accounts might not work.
94+
95+
Translators can go to the [Plone project in Weblate](https://hosted.weblate.org/projects/plone/).
96+
97+
You will see several components listed.
98+
The `volto` component is for the package `volto`, whose repository is at https://github.com/plone/volto.
9599

96100
```{note}
97101
At this moment Volto translations can't be contributed using Weblate.
98102
The Volto Team are working on this issue, and hope to fix it as soon as possible.
99103
```
100104

105+
All other components are for the package `plone.app.locales`, whose repository is at https://github.com/collective/plone.app.locales.
106+
107+
See the Weblate documentation, [Translating using Weblate](https://docs.weblate.org/en/latest/user/translating.html), for how to use it to write translations.
108+
109+
When you save a translation, then it is committed on a branch used only for translations in the respective GitHub repository.
110+
111+
[Compare recent commits to the branch `translations-plone` on the package `plone.app.locales`](https://github.com/collective/plone.app.locales/compare/master...translations-plone).
112+
113+
Maintainers will periodically create a pull request from the changes, and merge it.
114+
101115

102116
(contributing-plone-core-translations-support-label)=
103117

0 commit comments

Comments
 (0)