chore: release docs and script updates | FC-12

Makefile

@@ -1,12 +1,9 @@
-.PHONY: piptools upgrade fix_transifex_resource_names translations_scripts_requirements validate_translation_files \
-sync_translations sync_translations_github_workflow rerun_tests_for_transifex_bot_pull_requests
-
-
-# Default languages for the sync_translations.py file
-# This list represents the supported languages by the Open edX community as stated by the Translators Working Group:
-#   - https://openedx.atlassian.net/wiki/spaces/COMM/pages/3157524644/Translation+Working+Group#The-following-is-a-table-of-the-latest-list-of-languages-supported--by-the-Translation-Working-Group
-export TX_LANGUAGES := ar,da,de_DE,el,es_419,es_ES,fr_CA,hi,he,id,it_IT,pt_BR,pt_PT,ru,th,tr_TR,uk,zh_CN
+.PHONY: piptools upgrade fix_transifex_resource_names translations_scripts_requirements \
+validate_translation_files test_requirements test fix_transifex_resource_names_dry_run \
+retry_merge_transifex_bot_pull_requests
 
+# Default project to work on. Override to release project e.g. `openedx-translations-redwood` when cutting a release.
+export TRANSIFEX_PROJECT_SLUG := openedx-translations
 
 piptools:
 	pip install -q -r requirements/pip_tools.txt
@@ -24,10 +21,10 @@ upgrade: piptools  ## update the requirements/*.txt files with the latest packag
 translations_scripts_requirements:  ## Installs the requirements file
 	pip install -q -r requirements/translations.txt
 
-fix_transifex_resource_names:  ## Runs the script
+fix_transifex_resource_names:  ## Runs the script on the TRANSIFEX_PROJECT_SLUG project
 	python scripts/fix_transifex_resource_names.py
 
-fix_transifex_resource_names_dry_run:  ## Runs the script in --dry-run mode
+fix_transifex_resource_names_dry_run:  ## Runs the script in --dry-run mode on the TRANSIFEX_PROJECT_SLUG project
 	python scripts/fix_transifex_resource_names.py --dry-run
 
 
@@ -40,12 +37,6 @@ test:  ## Run scripts tests
 validate_translation_files:  ## Run basic validation to ensure files are compilable
 	python scripts/validate_translation_files.py
 
-sync_translations:  ## Syncs from the old projects to the new openedx-translations project
-	python scripts/sync_translations.py $(SYNC_ARGS)
-
-sync_translations_github_workflow:  ## Run with parameters from .github/workflows/sync-translations.yml
-	make SYNC_ARGS="--simulate-github-workflow $(SYNC_ARGS)" sync_translations
-
 export MAX_PULL_REQUESTS_TO_RESTART := 1000
 retry_merge_transifex_bot_pull_requests:  ## Fix Transifex bot stuck and unmerged pull requests.
 	bash scripts/retry_merge_transifex_bot_pull_requests.sh

README.rst

@@ -1,7 +1,7 @@
 openedx-translations
 ####################
 
-The openedx-translations repository contains translation files from Open edX repositories
+This openedx-translations repository contains translation files from Open edX repositories
 to be kept in sync with Transifex. To accomplish this task, a GitHub Action in
 ``.github/workflows/`` named ``extract-translation-source-files.yml`` regularly extracts
 English translation source files form Open edX repositories containing code and adds them
@@ -11,20 +11,67 @@ into this repository. The translation files in this repository can then be acces
 using the `openedx-atlas`_ CLI tool to download specific directories of translation files
 from openedx-translations.
 
-Current State
-*************
+This repository implements the `OEP-58`_ proposal.
 
-This repository is currently under active development with limited use.
-The GitHub Action
-``extract-translation-source-files.yml`` generates English translation source
-files for the configured repositories. These translation source files are the only
-ones uploaded to the Transifex project openedx-translations. The English translation
-source files have only been translated into one language: French Canadian (fr_CA). The
-`openedx-atlas`_ CLI tool can only be used to pull translation files from the credentials
-directory in openedx-translations.
+Main and Release branches
+*************************
+
+This repository has a main branch in addition to a dedicated branch for every
+release. As of May 10th, 2024 the following are the release branches:
+
+**`main <https://github.com/openedx/openedx-translations>`_ branch:**
+This branch is used for the latest version of Open edX such as
+`Tutor nightly`_, `edx-platform "master" branch`_ and others.
+
+To translate the latest versions the `open-edx/openedx-translations`_ Transifex
+project should be used.
+
+
+**`open-release/redwood.master branch <https://github.com/openedx/openedx-translations/tree/open-release/redwood.master>`_:**
+
+This branch is used for the latest version of Open edX such as
+`Tutor Redwood v18`_,
+`edx-platform "open-release/redwood.master" branch`_
+and others.
+
+To translate the latest versions the `open-edx/openedx-translations-redwood`_
+Transifex project should be used.
+
+Tools for repository maintainers
+********************************
+
+This repository contains both GitHub Actions workflows and Makefile programs
+to automate and assist maintainers chores including:
+
+Fix resource names in Transifex
+===============================
+
+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``.
+
+Running this command should be safe and can be ran multiple times on
+both the main ``openedx-translations`` project or on release projects
+by setting the ``TRANSIFEX_PROJECT_SLUG`` make variable as shown below::
+
+    # 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
+
+
+Retry merging Transifex pull requests
+=====================================
+
+Transifex creates pull requests to update translations and those pull
+requests are merged automatically. However, sometimes GitHub Actions goes down
+and those pull requests gets stuck.
+
+To re-trigger the merge the following Make program can be used::
+
+    make retry_merge_transifex_bot_pull_requests
 
 Translation validation
-**********************
+======================
 
 This repository validates translations with the GNU gettext ``msgfmt`` tool.
 
@@ -46,31 +93,16 @@ pull requests, run the following command:
 
     make retry_merge_transifex_bot_pull_requests
 
-
-Translations sync from old Transifex projects
-*********************************************
-
-This repository allows for syncing translations old
-`open-edx/edx-platform`_ and `open-edx/xblocks`_ Transifex projects into
-the new `open-edx/openedx-translations`_ Transifex project. This is done by
-trigger the `sync_translations.yml workflow on GitHub`_.
-
-Alternatively, you can run the following command to trigger the workflow:
-
-.. code-block:: bash
-
-    # Run with parameters from .github/workflows/sync-translations.yml
-    make sync_translations_github_workflow
-
-
-For more information, please see the pull request for `OEP-58`_.
-
-
 .. _OEP-58: https://github.com/openedx/open-edx-proposals/pull/367
 .. _openedx-atlas: https://github.com/openedx/openedx-atlas
 
 .. _sync_translations.yml workflow on GitHub: https://github.com/openedx/openedx-translations/actions/workflows/sync-translations.yml
 
-.. _open-edx/edx-platform: https://app.transifex.com/open-edx/edx-platform/dashboard/
-.. _open-edx/xblocks: https://app.transifex.com/open-edx/xblocks/dashboard/
 .. _open-edx/openedx-translations: https://app.transifex.com/open-edx/openedx-translations/dashboard/
+.. _open-edx/openedx-translations-redwood: https://app.transifex.com/open-edx/openedx-translations-redwood/dashboard/
+
+
+.. _Tutor nightly: https://docs.tutor.edly.io/tutorials/nightly.html
+.. _edx-platform "master" branch: https://github.com/openedx/edx-platform
+.. _Tutor Redwood v18: https://docs.tutor.edly.io/
+.. _edx-platform "open-release/redwood.master" branch: https://github.com/openedx/edx-platform/tree/open-release/redwood.master

scripts/fix_transifex_resource_names.py

@@ -39,9 +39,23 @@ def is_dry_run():
     return '--dry-run' in sys.argv
 
 
+def get_transifex_project_slug():
+    """
+    Get Transifex project slug e.g. openedx-translations or openedx-translations-redwood.
+    """
+    slug = getenv('TRANSIFEX_PROJECT_SLUG')
+    if not slug:
+        raise RuntimeError(
+            'Error: Cannot determine Transifex project slug. Set `TRANSIFEX_PROJECT_SLUG` environment variable to '
+            '"openedx-translations" or "openedx-translations-redwood".'
+        )
+
+    return slug
+
+
 def get_transifex_project():
     """
-    Get openedx-translations project from Transifex.
+    Get the translations project object from Transifex.
     """
     transifex_api_token = getenv('TRANSIFEX_API_TOKEN')
     if not transifex_api_token:
@@ -58,7 +72,7 @@ def get_transifex_project():
     transifex_api.setup(auth=transifex_api_token)
 
     openedx_org = transifex_api.Organization.get(slug='open-edx')
-    return openedx_org.fetch('projects').get(slug='openedx-translations')
+    return openedx_org.fetch('projects').get(slug=get_transifex_project_slug())
 
 
 def get_repo_slug_from_resource(resource):
@@ -101,7 +115,7 @@ def main(argv):
         print(__doc__)
         return
 
-    print('Updating openedx-translations project resource and slug names:')
+    print(f'Updating "{get_transifex_project_slug()}" project resource and slug names:')
 
     openedx_translations_proj = get_transifex_project()
     for resource in openedx_translations_proj.fetch('resources'):