Skip to content

Commit 6dc2da4

Browse files
committed
Mention POT-Creation-Date in instructions
I don’t know if this is enough on its own? In principle, the new publication system should work smoothly without people having to know much about this header, so that’s why I only describe it briefly. Followup to #1243.
1 parent fa1f19e commit 6dc2da4

File tree

1 file changed

+14
-7
lines changed

1 file changed

+14
-7
lines changed

TRANSLATIONS.md

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -100,18 +100,25 @@ Next, please update the file `.github/labeler.yml` to include the new language:
100100
101101
### Refreshing an Existing Translation
102102

103-
As the English text changes, translations gradually become outdated. To update
104-
the `po/xx.po` file with new messages, first extract the English text into a
105-
`po/messages.pot` template file. Then run
103+
As the English text changes, translations gradually become outdated. The
104+
translations contain a POT-Creation-Date header which tells you when they were
105+
last updated with new English messages.
106+
107+
To update the `po/xx.po` file with new messages, first extract the English text
108+
into a `po/messages.pot` template file. Then run
106109

107110
```shell
108111
msgmerge --update po/xx.po po/messages.pot
109112
```
110113

111-
Unchanged messages will stay intact, deleted messages are marked as old, and
112-
updated messages are marked "fuzzy". A fuzzy entry will reuse the previous
113-
translation: you should then go over it and update it as necessary before you
114-
remove the fuzzy marker.
114+
Notice that the POT-Creation-Date field is updated to the current time and date.
115+
This becomes the new baseline for the translation: new English text added
116+
afterwards will not show up in your translation, including completely new pages.
117+
118+
When running `msgmerge`, unchanged messages stay intact, deleted messages are
119+
marked as old, and updated messages are marked "fuzzy". A fuzzy entry is not
120+
used when we publish a translation! You have to go over the fuzzy entries by
121+
hand and verify that the translation is correct the fuzzy marker.
115122

116123
> **Note:** Your PRs should either be the result of running `msgmerge` or the
117124
> result of new translation work on the PO file for your language. Avoid mixing

0 commit comments

Comments
 (0)