Bug 1307571: dissuade use of templates; r=Callek

MozReview-Commit-ID: C3PZItmMJcs

--HG--
extra : rebase_source : 53d84145e19573d2e7b25b530a40dabcbe953e47
This commit is contained in:
Dustin J. Mitchell 2016-10-04 21:05:43 +00:00
parent a9818e5b7c
commit c6b11c1a07

View File

@ -1,13 +1,17 @@
Task Definition YAML Templates Task Definition YAML Templates
============================== ==============================
Many kinds of tasks are described using templated YAML files. These files A few kinds of tasks are described using templated YAML files. These files
allow some limited forms of inheritance and template substitution as well as allow some limited forms of inheritance and template substitution as well as
the usual YAML features, as described below. the usual YAML features, as described below.
Please use these features sparingly. In many cases, it is better to add a Please do not use these features in new kinds. If you are tempted to use
feature to the implementation of a task kind rather than add complexity to the variable substitution over a YAML file to define tasks, please instead
YAML files. implement a new kind-specific transform to accopmlish your goal. For example,
if the current push-id must be included as an argument in
``task.payload.command``, write a transform function that makes that assignment
while building a job description, rather than parameterizing that value in the
input to the transforms.
Inheritance Inheritance
----------- -----------