Skip to content

Commit 4ed62e2

Browse files
committed
[TASK] More wording
1 parent 038e3b6 commit 4ed62e2

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

Documentation/HandlingAPatch/Tips.rst

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -348,13 +348,17 @@ When changes are made to **Xliff files** (translations):
348348
* Is the **correct spelling** in American (US) English used?
349349
* Does the file use **proper indentation levels and characters** (tab)?
350350
* If an **existing** language key is changed on a LTS branch, it must **NOT introduce new
351-
argument placeholders** or remove existing ones. Instead, a new language key has to be
351+
argument placeholders** or remove existing ones, or change the meaning
352+
of an existing label. Instead, a new language key has to be
352353
introduced (and the old one can be removed or at least deprecated/documented as outdated).
353-
This is important because localizations are delivered for any TYPO3 patch-level version,
354-
and could cause PHP exceptions when **argument placeholders mismatch**.
355-
* When labels are removed, translations will fall back to their english
356-
counterpart. This is better than carrying around deprecated language
357-
labels which are no longer emitted in the TYPO3 core.
354+
This is important because localizations are only specific to the main
355+
version, and delivered for any TYPO3 patch-level version. So this
356+
could cause PHP exceptions when **argument placeholders mismatch**.
357+
When labels are removed, translations will fall back to their english
358+
counterpart in prior patchlevel versions.
359+
* Existing language labels in the `main` branch can be adjusted without being
360+
considered "breaking", since no LTS releases are made based off
361+
this.
358362

359363
.. _common-review-checks-missing:
360364
More?

0 commit comments

Comments
 (0)