gecko-dev/taskcluster/docs/index.rst
Gregory Szorc 365d4042e9 Bug 1448438 - Document how to upgrade Mercurial in CI; r=sheehan
We don't have docs for how to upgrade Mercurial in CI. A lot of it
is organic institutional knowledge that lives in various people's
heads. That's not good for continuity of business.

This commit starts to establish documentation for how to upgrade
Mercurial in Firefox CI.

The documentation for updating things in-tree is pretty robust
(because I've done it a handful of times and know what is involved).
But the docs for OpenCloudConfig and Puppet could certainly be
improved. I'll poke the respective maintainers of these systems
to help improve these docs as a follow-up.

MozReview-Commit-ID: Aruh3N8Llls

--HG--
extra : rebase_source : 5d82ffd1d2b808082d824274db33586f71899599
2018-03-23 12:43:36 -07:00

37 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
release-promotion
versioncontrol
how-tos
reference