You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
From time to time, we want to be able to synchronize the French translation of the documentation with the existing API documentation. In order to do this, @RondeauG has written a script powered by a translation engine that can update existing po files. The issue is that running this manually can be easily forgotten.
Potential Solution
We can run this within our CI pipelines if we want. The necessary library requirements should be found in the requrements_ci.* files. We also need to draft a new workflow to do this and determine when we want to trigger it and how to accept changes from it.
Perhaps if we had a process that was triggered when API changes were made, then ran the script, committed the changes, and opened a Pull Review for us to verify, that could work? We could have a dedicated branch that rebases on main and solely adds translations.
Another option is to have this set up as a commit hook, which I detest:
Requires internet access to perform commit.
Setting repo-level hooks manually is somewhat involved as a process.
The script can sometimes return different results (AI-based) so failures/changes can happen very often.
Addressing a Problem?
From time to time, we want to be able to synchronize the French translation of the documentation with the existing API documentation. In order to do this, @RondeauG has written a script powered by a translation engine that can update existing
po
files. The issue is that running this manually can be easily forgotten.Potential Solution
We can run this within our CI pipelines if we want. The necessary library requirements should be found in the
requrements_ci.*
files. We also need to draft a new workflow to do this and determine when we want to trigger it and how to accept changes from it.Perhaps if we had a process that was triggered when API changes were made, then ran the script, committed the changes, and opened a Pull Review for us to verify, that could work? We could have a dedicated branch that rebases on
main
and solely adds translations.Another option is to have this set up as a commit hook, which I detest:
Additional context
Related to #63
Contribution
The text was updated successfully, but these errors were encountered: