about summary refs log tree commit diff
path: root/src/doc/rustc-dev-guide
diff options
context:
space:
mode:
authorMarcoIeni <11428655+MarcoIeni@users.noreply.github.com>2025-07-01 15:08:26 +0200
committerMarcoIeni <11428655+MarcoIeni@users.noreply.github.com>2025-07-01 15:08:26 +0200
commitf5f2011bbe9342c37bf585e0d5b0f9a81df4128c (patch)
tree3637de159b9cf76021ef17b16276bef916b8582f /src/doc/rustc-dev-guide
parent86e05cd300fac9e83e812c4d46582b48db780d8f (diff)
downloadrust-f5f2011bbe9342c37bf585e0d5b0f9a81df4128c.tar.gz
rust-f5f2011bbe9342c37bf585e0d5b0f9a81df4128c.zip
document optional jobs
Diffstat (limited to 'src/doc/rustc-dev-guide')
-rw-r--r--src/doc/rustc-dev-guide/src/tests/ci.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/src/doc/rustc-dev-guide/src/tests/ci.md b/src/doc/rustc-dev-guide/src/tests/ci.md
index 96e4edc17a5..894c89b3d40 100644
--- a/src/doc/rustc-dev-guide/src/tests/ci.md
+++ b/src/doc/rustc-dev-guide/src/tests/ci.md
@@ -148,6 +148,13 @@ for example `*msvc*` or `*-alt`. You can start at most 20 jobs in a single try b
 glob patterns, you might want to wrap them in backticks (`` ` ``) to avoid GitHub rendering
 the pattern as Markdown.
 
+The job pattern needs to match one or more jobs defined in the `auto` or `optional` sections
+of [`jobs.yml`]:
+
+- `auto` jobs are executed before a commit is merged into the `master` branch.
+- `optional` jobs are executed only when explicitly requested via a try build.
+  They are typically used for tier 2 and tier 3 targets.
+
 > **Using `try-job` PR description directives**
 >
 > 1. Identify which set of try-jobs you would like to exercise. You can