summaryrefslogtreecommitdiffstats
path: root/comm/taskcluster/docs/kinds.rst
blob: 85618c43da9873d0b1c2e4a8546417dea950c887 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
Task Kinds
==========

This section lists and documents the additional task kinds that are specific
to Thunderbird and are implemented in it's source tree.

shippable-l10n-pre
------------------
Prepares a build artifact containing the translated strings from all locales.
The artifact is consumed by `shippable-l10n` to produce the localized
Thunderbird builds.

Using
.....

- kind-dependencies:
    Must include `build`
- transforms:
    Must include `comm_taskgraph.transforms.l10n_pre:transforms`
- only-for-attributes:
    Must include `shippable`
- only-for-build-platforms:
    This is set to `linux64-shippable/opt` so that it only runs for that
    platform. All platforms will consume the build artifact from
    `linux64-shippable/opt`. (It's just string data; nothing platform-specific
    in there.)

Parameters
..........

There are some task parameters specific to this job kind.

- locale-list:
  Points to either `shipped-locales` or `all-locales`. This file is used to
  select the locales that are included in the build artifact.
- comm-locales-file:
  This file contains the revision of the `comm-l10n` monorepo to checkout.
- browser-locales-file:
  This file contains the revisions of the `l10n-central` repositories to checkout.
  This is for toolkit and other strings used from mozilla-central.

Other notes
...........

The mozharness script reads its configuration from `thunderbird_split_l10n.py`.
In that file, `hg_l10n_base` refers to the `l10n-central` repository root.
This is used with `browser-locales-file` to get the strings from toolkit and
devtools that are needed.

Also in the mozharness config file is `hg_comm_l10n_repo`, set to the URL of
the `comm-l10n` monorepo.

The mozharness script will clone the necessary repositories from `l10n-central`,
and `comm-l10n`, merge them, and create a tar file.


shippable-l10n-pre-signing
--------------------------

Signing job for shippable-l10n-pre artifacts

beetmover-strings-source
------------------------

Upload strings source files to FTP.