From 339b72f3c4a10037a345d88763622bb9e78c2a6b Mon Sep 17 00:00:00 2001 From: Jacob Walls Date: Thu, 2 Apr 2026 14:20:42 -0400 Subject: [6.0.x] Fixed #37020 -- Removed guidance to edit fetched .po files by hand. Altering the .po files by hand was causing incorrect line numbers and plural forms. Since our fetching procedure does not recompile any hand-edited .po files to .mo files for production use, just accept Transifex's plural forms as a source of truth. https://forum.djangoproject.com/t/discourage-releasers-from-editing-po-files-by-hand/44441 Backport of 9391beeb8799a4b7deb4bb3048bd63465a0e96ef from main. --- docs/internals/howto-release-django.txt | 15 +-------------- 1 file changed, 1 insertion(+), 14 deletions(-) diff --git a/docs/internals/howto-release-django.txt b/docs/internals/howto-release-django.txt index 90c627a40e..b2738ea521 100644 --- a/docs/internals/howto-release-django.txt +++ b/docs/internals/howto-release-django.txt @@ -210,10 +210,7 @@ A few days before any release for the new release; this will be in ``docs/releases/index.txt``. #. If this is a :term:`feature release`, ensure translations from Transifex - have been integrated. This is typically done by a separate translation's - manager rather than the releaser, but here are the steps. This process is a - bit lengthy so be sure to set aside 4-10 hours to do this, and ideally plan - for this task one or two days ahead of the release day. + have been integrated. In addition to having a configured Transifex account, ensure that the `tx CLI `_ is available in your @@ -240,12 +237,6 @@ A few days before any release $ git diff --name-only stable/5.0.x | grep "\.po" | xargs sed -ri "s/PO-Revision-Date: [0-9\-]+ /PO-Revision-Date: $(date -I) /g" - All the new ``.po`` files should be manually and carefully inspected to - avoid committing a change in a file without any new translations. Also, - there shouldn't be any changes in the "plural forms": if there are any - (usually Spanish and French report changes for this) those will need - reverting. - Lastly, commit the changed/added files (both ``.po`` and ``.mo``) and create a new PR targeting the stable branch of the corresponding release (example `PR updating translations for 4.2 @@ -730,10 +721,6 @@ You're almost done! All that's left to do now is: $ django-admin makemessages -l en --domain=djangojs --domain=django processing locale en - #. Review the diff before pushing and avoid committing changes to the - ``.po`` files without any new translations (:commit:`example commit - `). - #. Make a pull request against the corresponding stable branch and merge once approved. -- cgit v1.3