Versions Compared

Old Version 237

changes.mady.by.user Omar Al-Ithawi

Saved on

compared with

New Version Current

changes.mady.by.user Omar Al-Ithawi

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Update the pull request template in the master branch of edx/edx-platform to encourage developers to contribute bugfixes back to both the upcoming & next release branches (see for instance this PR).

6. Create the release Transifex project

Note

Translations after OEP-58 requires a new Transifex project for each named release. This will ensure the translations sources and code source stay in sync after main branches continue to evolve after cutting the release.

Creating multiple projects isn’t ideal and can be revisited if it turns out to harm the Translator Experience.

6a Double check the openedx-translations repository branch

Go to the https://github.com/openedx/openedx-translations repository and ensure it has the proper release branch e.g. open.release/zebrawood.master.

6b Clone the openedx-translations Transifex project

  • Create a new Transifex project: openedx-translations-zebrawood.

  • Add all the languages from the openex-translatiosn Transifex project.

6c Configure the GitHub Transifex App

This is a manual step:

  • Go to the Zebrawood Transifex project (openedx-translations-zebrawood) configuration settings

  • In the Integrations tab, click on the GitHub App integration “Install” button

    • Allow the integration

    • Grant permission to your account

    • Grant permission to the openedx/openedx-translations repository

  • Continue the wizard to configure the project integrations to the following:

    • Select repo step:

      • Selected repository: openedx/openedx-translations

      • Selected branch: Set it to the release branch e.g. open.release/zebrawood.master

    • Select files step:

      • Set the path to your YAML configuration file to transifex.yml

    • Sync content step:

      • PULL CONTENT: Fetch content automatically

      • PUSH CONTENT: 100% reviewed

      • Set “How would you like Transifex to push translations to GitHub?” to Create a Pull Request and No grouping

      • Add a prefix to the commit message: chore:

    • Click on the Update Settings button

    • Wait for the sync to complete. It takes about an hour.

    • ☑️ Ensure that all the resources has been added.

6d Update the Transifex resources names and tags

The GitHub Transifex App integeration puts an inconvenient names for resources like "translations..frontend-app-something..src-i18n-transifex-input--main" instead of "frontend-app-something".

This can be fixed with the following command locally:

Code Block
git clone https://github.com/openedx/openedx-translations.git
cd openedx-translations
mkvirtualenv openedx-translations
pip install -r requirements/requirements.txt
# Dry run the name fix
make TRANSIFEX_PROJECT_SLUG='openedx-translations-zebrawood' fix_transifex_resource_names_dry_run
# If runs without errors, run the actual command:
make TRANSIFEX_PROJECT_SLUG='openedx-translations-zebrawood' fix_transifex_resource_names

🎁 Tagging a release or release candidate (Tagging Numbered Releases)

...

The .1 suffix is so that you can make a .2 if something needs to be fixed.

2b. Update and upload translations on the test branch

TBD translation insturctions.

2c. Test the release one last time

...