Bug 1415619: Add some sphinx documentation pointing at taskgraph configuration. draft
authorTom Prince <mozilla@hocat.ca>
Wed, 15 Nov 2017 14:17:07 -0700
changeset 699900 9308757c3b29388f405238513fa8c71507556c9a
parent 699899 de95ec5a42fc5b49d9c0a5cdc0956e3989a8cf40
child 740760 dd1ae3885b194501b24965ca6e3f29a9d27e4441
push id89714
push userbmo:mozilla@hocat.ca
push dateFri, 17 Nov 2017 21:55:39 +0000
bugs1415619
milestone59.0a1
Bug 1415619: Add some sphinx documentation pointing at taskgraph configuration. MozReview-Commit-ID: 3EAu9bkln8h
taskcluster/docs/taskgraph.rst
--- a/taskcluster/docs/taskgraph.rst
+++ b/taskcluster/docs/taskgraph.rst
@@ -164,16 +164,25 @@ using simple parameterized values, as fo
 
 ``{"task-reference": "string containing <dep-name>"}``
     The task definition may contain "task references" of this form.  These will
     be replaced during the optimization step, with the appropriate taskId for
     the named dependency substituted for ``<dep-name>`` in the string.
     Multiple labels may be substituted in a single string, and ``<<>`` can be
     used to escape a literal ``<``.
 
+Graph Configuration
+-------------------
+
+There are several configuration settings that are pertain to the entire
+taskgraph. These are specified in :file:`config.yml` at the root of the
+taskgraph configuration (typically :file:`taskcluster/ci`). The available
+settings are documented inline in `taskcluster/taskgraph/config.py
+<https://dxr.mozilla.org/mozilla-central/source/taskcluster/taskgraph/config.py>`_.
+
 .. _taskgraph-trust-domain:
 
 Trust Domain
 ------------
 
 When publishing and signing releases, that tasks verify their definition and
 all upstream tasks come from a decision task based on a trusted tree. (see
 `chain-of-trust verification <http://scriptworker.readthedocs.io/en/latest/chain_of_trust.html>`).