summaryrefslogtreecommitdiffstats
path: root/comm/taskcluster/docs/loading.rst
diff options
context:
space:
mode:
Diffstat (limited to 'comm/taskcluster/docs/loading.rst')
-rw-r--r--comm/taskcluster/docs/loading.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/comm/taskcluster/docs/loading.rst b/comm/taskcluster/docs/loading.rst
new file mode 100644
index 0000000000..3c9c5b1468
--- /dev/null
+++ b/comm/taskcluster/docs/loading.rst
@@ -0,0 +1,34 @@
+Loading
+=======
+
+Overview
+--------
+
+See the Firefox loading documentation. In addition to those loaders, in
+``comm_taskgraph.loader`` there are loaders for Thunderbird.
+
+
+comm_taskgraph.loader
+---------------------
+
+reference
+.........
+
+Loads selected jobs from a different taskgraph hierarchy.
+
+The ``reference`` loader is used to import kinds from the Firefox Taskcluster
+base path.
+
+``packages``, and ``fetch`` use this loader.
+
+merge
+.....
+
+Loads jobs for a kind from two Taskcluster base paths. The results are "merged"
+together into a single kind, allowing for using the Firefox defined jobs as
+a base and adding additional jobs.
+
+First jobs are imported from Firefox's Taskcluster base path using the reference
+loader. Then jobs are read from the kind directory using ``jobs-from``.
+
+``docker-image`` and ``toolchain`` use this loader.