Hi Dmitriy

That’s a very good point. All translations in Zanata will be migrated. So if docs were translated for some projects in Zanata, those translations will also be migrated to Weblate. ( For example contributor-guide )

Before shutting down Zanata, we will ensure there is enough time to gather feedback from the community. If there are any shortcomings in the migration to Weblate, we will continue to address and improve them.

Seongsoo

On Tue, Sep 30, 2025 at 2:06 PM Dmitriy Rabotyagov <noonedeadpunk@gmail.com> wrote:

Hey!

Thanks for the update and working on this, it's amazing to finally having a progress on this one. 

Did I got it right, that docs/ translations is not gonna be migrated before zanata is shut down? As we put quite some effort recently into docs translation for some projects, so loosing these translations and not being able to maintain them after migration is "complete" sounds like a big downer at the moment.

While I understand that it's more effort, but bringing such a regression is also sub-ideal.

So I was thinking if there is possibility to leave zanata running just for the docs, in case they can not be migrated due to time constraints?

On Tue, 30 Sept 2025, 06:42 Seongsoo Cho, <ppiyakk2@printf.kr> wrote:

Hello i18n team,

OpenStack's current translation platform(translation.openstack.org) is based on Zanata, which is no longer maintained. To ensure a sustainable translation workflow, the i18n team has been migrating from Zanata to Weblate.

This work officially started following the CMU Summer semester mentoring shared by Kendall Nelson in May (link), and has since been moving forward in collaboration with the Korea User Group and mentees participating in the government-sponsored Open Source Contribution Academy program.

1. Migration progress

Migration scope:
  - Download translated .po files from Zanata and upload them to Weblate
  - The same language set configured in Zanata is also applied in Weblate.

Branches:
  - Currently, only the master branch is being migrated.
  - We are exploring ways to support stable branches in the future.
 
Migration Contents:
  - At this stage, the migration targets strings inside source code and release notes.
  - We are in the process of expanding this to include documentation as well.

We started with Horizon and its plugins, and the following projects have already been successfully migrated to Weblate:
• cloudkitty-dashboard
• designate-dashboard
• freezer-web-ui
• heat-dashboard
• horizon
• ironic-ui
• magnum-ui
• manila-ui
• networking-bgpvpn
• neutron-fwaas-dashboard
• neutron-vpnaas-dashboard
• octavia-dashboard
• trove-dashboard
• zaqar-ui
• zun-ui

2. New Zuul jobs for Weblate

To replicate the existing Zanata-based Zuul workflow, we are adding new Weblate jobs.
• Patch: https://review.opendev.org/c/openstack/openstack-zuul-jobs/+/921878

We plan to reuse the translation-jobs-master-only Zuul templates and update the following playbooks to run both Zanata and Weblate tasks:
• https://opendev.org/openstack/project-config/src/branch/master/playbooks/translation/upstream-translation-update.yaml
• https://opendev.org/openstack/project-config/src/branch/master/playbooks/translation/propose-translation-update.yaml
• Patch: https://review.opendev.org/c/openstack/project-config/+/961499

3. Migration scripts

Although they are one-off scripts, we are adding them to the i18n repository to document how we migrated from Zanata to Weblate.
• Language sync tool: https://review.opendev.org/c/openstack/i18n/+/961371
• Zanata-to-Weblate migration tool: https://review.opendev.org/c/openstack/i18n/+/961075

4. Next steps for migration

We have implemented everything needed to replace the Zanata-based jobs with Weblate. Once the Zuul job patches are merged, we will verify the upstream pipeline.

Our goal is to migrate all projects from Zanata to Weblate by October. After verifying the pipeline, we plan to shut down Zanata.

5. Future plans

Beyond this migration, we plan to expand translation targets — including OpenStack governance documents and the docs/ directories of many projects — to provide broader translation opportunities.

Anyone interested in contributing is warmly welcome to join us in the #openstack-i18n IRC channel and say hello!

Thanks,

Best Regards

Seongsoo Cho

--

Seongsoo Cho

OpenStack Korea User Group / Community Leader

IRC #seongsoocho

_______________________________________________
OpenStack-I18n mailing list -- openstack-i18n@lists.openstack.org
To unsubscribe send an email to openstack-i18n-leave@lists.openstack.org

--

Seongsoo Cho

OpenStack Korea User Group / Community Leader

IRC #seongsoocho