fune/taskcluster/docs/index.rst
Dustin J. Mitchell 98a3631d7b Bug 1391776: cleanup of taskgraph docs; r=ahal
* eliminate heading for test kinds, of which there is now only one
* make the caches document have a single heading in the TOC
* break out mach commands into a separate document, add ./mach taskgraph morphed
* remove docs for YAML templates support (the .yml file wasn't actually
  used -- I expect it was a merge leftover); these are still used for actions.yml,
  but once that is gone the code should be removed, too.
* break try out into its own document, edit to distinguish "how to run try"
  from "how to generate config"

MozReview-Commit-ID: 76ZopWA9TPL

--HG--
extra : rebase_source : 6946d866f9df6eec591b9a05ddedc6467dd69e4b
2017-08-23 15:22:10 -04:00

34 lines
1.1 KiB
ReStructuredText

.. taskcluster_index:
TaskCluster Task-Graph Generation
=================================
The ``taskcluster`` directory contains support for defining the graph of tasks
that must be executed to build and test the Gecko tree. This is more complex
than you might suppose! This implementation supports:
* A huge array of tasks
* Different behavior for different repositories
* "Try" pushes, with special means to select a subset of the graph for execution
* Optimization -- skipping tasks that have already been performed
* Extremely flexible generation of a variety of tasks using an approach of
incrementally transforming job descriptions into task definitions.
This section of the documentation describes the process in some detail,
referring to the source where necessary. If you are reading this with a
particular goal in mind and would rather avoid becoming a task-graph expert,
check out the :doc:`how-to section <how-tos>`.
.. toctree::
taskgraph
mach
loading
transforms
optimization
docker-images
cron
try
actions
how-tos
reference