openstack/i18n
Code Issues Proposed changes
i18n/doc/source/release_management.rst
Ian Y. Choi 4120e834f2 More description with releases 
- Describes that release activities are mainly related with
  cycle-with-milestone release model projects and translation
  targets
- Documentation in openstack-manuals follows independent
  release model and project repositories can have stable branch
  documents. Let's describe this.
- Also, explains that other official project can be a release
  target to I18n team upon request assuming that there is a
  cross-project liaison to I18n team.

Change-Id: Ibbcf797b11a58fb57b7dd044d1d6948ce5b06cbc
2018-07-07 16:54:10 +09:00

4.5 KiB
Raw Blame History

Team activities with release

This page documents what I18n team concerns and which things are needed to do with OpenStack releases. Each OpenStack release has around 6-month cycle and the corresponding schedule is available on https://releases.openstack.org/ (e.g., https://releases.openstack.org/ocata/schedule.html describes Ocata release schedule).

One of main goals in I18n team is to incorporate translated strings into a new release so that more global users experience translated version of OpenStack. To accomplish this goal, some of team activities need to be aligned with a release schedule.

Note

I18n team sets target projects to be translated and prioritizes during around the Forum (renamed from the Design Summit). Current translation plan and priority are available on translation dashboard.

Note

The terms in this page follow release schedule pages.

Projects affecting StringFreezes

Horizon and Horizon plugins are the main targets which affect StringFreezes. Note that StringFreezes are applied to cycle-with-milestone release model.

  1. [Project] Release milestone-3. Soft StringFreeze is in effect.
  2. [Translator] Start translations for the release.
    • Translate master version on Zanata.
  3. [I18n PTL] Call for translation
  4. [I18n PTL] Coordinate release and translation import schedule of individual projects with PTL or I18n liaison.
  5. [Project] Release RC1 and create a stable branch. Hard StringFreeze is in effect.
  6. [Zanata admin] Create a stable version such as stable-newton
    • The stable version is created from the master version on Zanata once RC1 is cut and a stable branch is created in a git repository.
    • Once a stable version corresponding to a project stable branch is created on Zanata, the infra script will push strings automatically.
  7. [Translator] Translate stable-XXXX version instead of master version on Zanata.
    • At this stage, the master version on Zanata is still open for translations, but it is strongly suggested to work on a stable version.
  8. [Infra] Setup translation jobs such as translation-jobs-newton to import translations for stable branches.
    • This should be done after a stable version on Zanata is created.
  9. [Translator] It is suggested to complete translation work by Monday or Tuesday of the Final RC week.
  10. [Project] RC2 or RC3 release will be shipped with latest translations. Final RC release will happen one week before the official release week.
  11. [Project] Official release!
  12. [Zanata admin] Merge a stable version back into the master version.
    • This usually happens within a week after the release.
    • The stable version is well reviewed, so it makes sense to merge translations into the master version on Zanata to avoid translating the same strings again.
  13. After the official release, translating master version is welcome for upstream translation contribution, but the original strings may be changed frequently due to upstream development on the projects.
  14. On the other hand, translating stable version as upstream contribution is not encouraged after the translated strings are packaged with releases. The stable version will be closed earlier than or around EOL.
  15. If there is a translation bug on a stable version in Zanata, it is highly recommended to fix the same translation bug on the corresponding string in the master version.

Documentation projects

All upstream OpenStack documents in openstack-manuals and project repositories use master branch and can have stable branches depending on release models and maintaining documents in different project teams. Cross-project liaisons are strongly encouraged to communiticate with I18n team so that I18n team can discuss and decide which stable documents are the target in I18n team and when translators start to translate stable documents.

  1. Translations on master version in Zanata are normally recommended for upstream contribution.
  2. After the documents are translated and reviewed well, updating existing www/<lang>/index.html or creating a new language landing page is needed.

Other projects supported with translation jobs

I18n team helps release activities on other projects if the projects have cross-project liaison on I18n team and upon request.