Skip to content

Commit d86e662

Browse files
committed
Merge bitcoin/bitcoin#22369: doc: Add steps for Transifex to release process
a16378e doc: Remove unnecessary steps from translations update process (Wladimir J. van der Laan) 2584929 doc: Add steps for transifex to release process (Wladimir J. van der Laan) Pull request description: Document how to update settings on and for the transifex website before and after branch-off of a new release. (This is #21440, updated with the review feedback.) ACKs for top commit: laanwj: ACK a16378e hebasto: ACK a16378e Tree-SHA512: 9669cc3bc7ba056f913ee77c2ef9d9ee2313da947fc07f8cd955807c34c5d39e3af73587adfe734274ab2412a7dfb1e2dfe7ee4904ca28cfef9bf8061d26a573
2 parents 21998bc + a16378e commit d86e662

File tree

2 files changed

+12
-9
lines changed

2 files changed

+12
-9
lines changed

doc/release-process.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,12 @@ Release Process
3737
- This update should be reviewed with a reindex-chainstate with assumevalid=0 to catch any defect
3838
that causes rejection of blocks in the past history.
3939
- Clear the release notes and move them to the wiki (see "Write the release notes" below).
40+
- Translations on Transifex
41+
- Create [a new resource](https://www.transifex.com/bitcoin/bitcoin/content/) named after the major version with the slug `[bitcoin.qt-translation-<RRR>x]`, where `RRR` is the major branch number padded with zeros. Use `src/qt/locale/bitcoin_en.xlf` to create it.
42+
- In the project workflow settings, ensure that [Translation Memory Fill-up](https://docs.transifex.com/translation-memory/enabling-autofill) is enabled and that [Translation Memory Context Matching](https://docs.transifex.com/translation-memory/translation-memory-with-context) is disabled.
43+
- Update the Transifex slug in [`.tx/config`](/.tx/config) to the slug of the resource created in the first step. This identifies which resource the translations will be synchronized from.
44+
- Make an announcement that translators can start translating for the new version. You can use one of the [previous announcements](https://www.transifex.com/bitcoin/bitcoin/announcements/) as a template.
45+
- Change the auto-update URL for the resource to `master`, e.g. `https://raw.githubusercontent.com/bitcoin/bitcoin/master/src/qt/locale/bitcoin_en.xlf`. (Do this only after the previous steps, to prevent an auto-update from interfering.)
4046

4147
#### After branch-off (on master)
4248

@@ -46,6 +52,8 @@ Release Process
4652

4753
- Update the versions.
4854
- Create a pinned meta-issue for testing the release candidate (see [this issue](https://github.com/bitcoin/bitcoin/issues/17079) for an example) and provide a link to it in the release announcements where useful.
55+
- Translations on Transifex
56+
- Change the auto-update URL for the new major version's resource away from `master` and to the branch, e.g. `https://raw.githubusercontent.com/bitcoin/bitcoin/<branch>/src/qt/locale/bitcoin_en.xlf`. Do not forget this or it will keep tracking the translations on master instead, drifting away from the specific major release.
4957

5058
#### Before final release
5159

doc/translation_process.md

Lines changed: 4 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -63,17 +63,12 @@ username = USERNAME
6363
The Transifex Bitcoin project config file is included as part of the repo. It can be found at `.tx/config`, however you shouldn’t need to change anything.
6464

6565
### Synchronising translations
66-
To assist in updating translations, a helper script is available in the [maintainer-tools repo](https://github.com/bitcoin-core/bitcoin-maintainer-tools).
6766

68-
1. `python3 ../bitcoin-maintainer-tools/update-translations.py`
69-
2. `git add` new translations from `src/qt/locale/`
70-
3. Update `src/qt/bitcoin_locale.qrc` manually or via
71-
```bash
72-
git ls-files src/qt/locale/*ts|xargs -n1 basename|sed 's/\(bitcoin_\(.*\)\).ts/ <file alias="\2">locale\/\1.qm<\/file>/'
67+
To assist in updating translations, a helper script is available in the [maintainer-tools repo](https://github.com/bitcoin-core/bitcoin-maintainer-tools). To use it and commit the result, simply do:
68+
7369
```
74-
4. Update `src/Makefile.qt_locale.include` manually or via
75-
```bash
76-
git ls-files src/qt/locale/*ts|xargs -n1 basename|sed 's/\(bitcoin_\(.*\)\).ts/ qt\/locale\/\1.ts \\/'
70+
python3 ../bitcoin-maintainer-tools/update-translations.py
71+
git commit -a
7772
```
7873

7974
**Do not directly download translations** one by one from the Transifex website, as we do a few post-processing steps before committing the translations.

0 commit comments

Comments
 (0)