Magic-Mirror/gecko-dev
1
0
Fork 0
mirror of https://github.com/mozilla/gecko-dev.git synced 2024-11-29 07:42:04 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Bug 1307571: dissuade use of templates; r=Callek

Browse Source 
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
1 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
taskcluster/docs/yaml-templates.rst
View File

@ -1,13 +1,17 @@
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
the usual YAML features, as described below.
Please use these features sparingly. In many cases, it is better to add a
feature to the implementation of a task kind rather than add complexity to the
YAML files.
Please do not use these features in new kinds. If you are tempted to use
variable substitution over a YAML file to define tasks, please instead
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
-----------