Make it easier for Weblate users to preview suggestions on the staging website
(This issue merges #15080 (closed) and sysadmin#15360 (closed).)
Requirements
The staging website is an important tool for translators to self-learn and improves the translation quality:
- allow Translators to preview their suggestions before they are accepted by Reviewers.
- allow all users see the context in which components/strings appear to have a better understanding of how it should be translated.
For that, is must:
- be readily available for a component/string from the Weblate interface, otherwise chances are translators won’t use the staging website much (if at all).
- not lag behind the changes one is reviewing most of the time, otherwise chances are that translators get used to ignore it because it’s not useful.
Implementation steps
-
Add to each Weblate component links to its corresponding pages in the staging website (take our multiple uses of [[!inline]]
into account). -
Add a link to the staging website in other places in Weblate with an explanatory sentence (eg. login page, banner, etc). -
Increase the frequency of staging website update (currently takes 1h and runs once a day) - Consider faster ways (currently takes 1h):
- Make sure IkiWiki is refreshing instead of rebuilding.
- Consider only updating subsets of languages and/or files.
- Use a systemd timer instead of cron (avoids concurrent runs)
- Avoid monopolizing a vCPU permanently (eg. if it takes 1h, run once every 4 hours).
- Consider faster ways (currently takes 1h):
-
Ensure the staging website build is resilient enough (i.e. doesn't break often -- some checks have already been implemented for that). -
Fix documentation accordingly.
Edited by Zen Fu