[Django] #37020: Adjust release instructions to stop editing *.po files fetched from Transifex

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------
Reporter: Jacob | Owner: Jacob Walls
Walls |
Type: | Status: assigned
Cleanup/optimization |
Component: | Version: dev
Documentation |
Severity: Normal | Keywords:
Triage Stage: | Has patch: 0
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
Per [https://forum.djangoproject.com/t/discourage-releasers-from-editing-
po-files-by-hand/44441 forum post], the procedure for pulling & pushing
files from/to Transifex has been corrupting both line numbers and plural
forms, leading to, in some cases, broken *.po files that do not compile to
*.mo, or *.po files that hide information (e.g. plural forms that might
appear in production).

I'm working on a PR to correct the files, improve the fetching script, and
correct the documentation.
--
Ticket URL: <https://code.djangoproject.com/ticket/37020>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------

Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage:
| Unreviewed
Has patch: 0 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Description changed by Jacob Walls:

Old description:

> Per [https://forum.djangoproject.com/t/discourage-releasers-from-editing-
> po-files-by-hand/44441 forum post], the procedure for pulling & pushing
> files from/to Transifex has been corrupting both line numbers and plural
> forms, leading to, in some cases, broken *.po files that do not compile
> to *.mo, or *.po files that hide information (e.g. plural forms that
> might appear in production).
>
> I'm working on a PR to correct the files, improve the fetching script,
> and correct the documentation.

New description:

Per [https://forum.djangoproject.com/t/discourage-releasers-from-editing-
po-files-by-hand/44441 forum post], the procedure for pulling & pushing
files from/to Transifex has been corrupting both line numbers and plural
forms, leading to, in some cases, broken *.po files that do not compile to
*.mo, or *.po files that hide information (e.g. plural forms that might
appear in production).

I'm working on a PR to correct the documentation. (EDIT: I think it makes
more sense to wait to correct the files until our next regularly scheduled
time to fetch, for the 6.1 prereleases).

--
--
Ticket URL: <https://code.djangoproject.com/ticket/37020#comment:1>

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage:
| Unreviewed

Has patch: 1 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls):

* has_patch: 0 => 1

Comment:

[https://github.com/django/django/pull/21048 PR]
--
Ticket URL: <https://code.djangoproject.com/ticket/37020#comment:2>

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:

Keywords: | Triage Stage: Accepted

Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Sarah Boyce):

* stage: Unreviewed => Accepted

Comment:

Accepting based off the forum discussion. This change sounds positive to
me
I feel there is a piece of work around migrating Transifex to Weblate as a
longer term plan. I tried to research current discussions on this and
added a note: https://forum.djangoproject.com/t/improving-the-process-of-
incorporating-translations-to-django/26140/17
--
Ticket URL: <https://code.djangoproject.com/ticket/37020#comment:3>

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:

Keywords: | Triage Stage: Ready for
| checkin

Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Natalia Bidart):

* stage: Accepted => Ready for checkin

--
Ticket URL: <https://code.djangoproject.com/ticket/37020#comment:4>

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: assigned
Component: Documentation | Version: dev
Severity: Normal | Resolution:
Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Jacob Walls <jacobtylerwalls@…>):

In [changeset:"4d8cc40c730cf0daf1d0c9a7e5ccd198b269b3ad" 4d8cc40]:
{{{#!CommitTicketReference repository=""
revision="4d8cc40c730cf0daf1d0c9a7e5ccd198b269b3ad"
Refs #37020 -- Corrected example command to update translation catalogs.

Passing the --domain flag again just overwrites the prior value.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/37020#comment:5>

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls

Cleanup/optimization | Status: closed
Component: Documentation | Version: dev
Severity: Normal | Resolution: fixed

Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Jacob Walls <jacobtylerwalls@…>):

* resolution: => fixed
* status: assigned => closed

Comment:

In [changeset:"9391beeb8799a4b7deb4bb3048bd63465a0e96ef" 9391bee]:
{{{#!CommitTicketReference repository=""
revision="9391beeb8799a4b7deb4bb3048bd63465a0e96ef"
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
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/37020#comment:6>

[Django]

#37020: Adjust release instructions to stop editing *.po files fetched from
Transifex
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: Jacob
Type: | Walls
Cleanup/optimization | Status: closed
Component: Documentation | Version: dev
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Comment (by Jacob Walls <jacobtylerwalls@…>):

In [changeset:"339b72f3c4a10037a345d88763622bb9e78c2a6b" 339b72f]:
{{{#!CommitTicketReference repository=""
revision="339b72f3c4a10037a345d88763622bb9e78c2a6b"
[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.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/37020#comment:7>