Skip to content

docs(dynamic-ci): build out the Dynamic CI section - #361

Open
EliSchleifer wants to merge 1 commit into
mainfrom
docs/dynamic-ci-setup-and-configuration
Open

EliSchleifer wants to merge 1 commit into
mainfrom
docs/dynamic-ci-setup-and-configuration

Conversation

@EliSchleifer

Copy link
Copy Markdown
Member

Seven pages beside the landing page, all gated to the dynamic-ci group and nested under the Overview tab's existing shell:

  • how-it-works — the request and the plan, the signals and how they combine, job identity, the pull-request and merge-queue lanes, learning vs enforced, fail-open and the notice codes, false skips.
  • use-cases — the situations the product is for, each with what to configure.
  • in-the-app — the four app surfaces and what each measure counts.
  • github-actions / buildkite — setup per provider, under a Setup group.
  • configuration — what happens with nothing set, repository mode, per-job policies, per-lane signal config, paths filters, ignore-signals, force overrides, scoping.
  • troubleshooting — nothing skipping, the conditional mistakes, required checks against matrix jobs, false skips, the Buildkite debug path.

The landing page keeps the overview and hands setup to the provider pages rather than carrying a GitHub Actions walkthrough itself.

Written from the shipped implementation rather than the design docs: the action's action.yaml and both READMEs in trunk-io/dynamic-ci, the public API's dynamic-ci schemas, the engine's lane config and policy loader, the Prisma models, and the frontend's segment and tile labels.

Two places where the documented behaviour and the action's README disagree, and the code is what got written down: the action is referenced as trunk-io/dynamic-ci@v1 (its real name; the README still says dynamic-ci-filter, which only resolves through GitHub's rename redirect), and the merge queue is described as skipping nothing unless a paths filter is configured for that lane, which is what the engine now does since the merge-queue branch short-circuit was retired.

Seven pages beside the landing page, all gated to the `dynamic-ci` group and
nested under the Overview tab's existing shell:

- how-it-works — the request and the plan, the signals and how they combine,
  job identity, the pull-request and merge-queue lanes, learning vs enforced,
  fail-open and the notice codes, false skips.
- use-cases — the situations the product is for, each with what to configure.
- in-the-app — the four app surfaces and what each measure counts.
- github-actions / buildkite — setup per provider, under a Setup group.
- configuration — what happens with nothing set, repository mode, per-job
  policies, per-lane signal config, paths filters, ignore-signals, force
  overrides, scoping.
- troubleshooting — nothing skipping, the conditional mistakes, required checks
  against matrix jobs, false skips, the Buildkite debug path.

The landing page keeps the overview and hands setup to the provider pages
rather than carrying a GitHub Actions walkthrough itself.

Written from the shipped implementation rather than the design docs: the
action's `action.yaml` and both READMEs in trunk-io/dynamic-ci, the public
API's dynamic-ci schemas, the engine's lane config and policy loader, the
Prisma models, and the frontend's segment and tile labels.

Two places where the documented behaviour and the action's README disagree, and
the code is what got written down: the action is referenced as
`trunk-io/dynamic-ci@v1` (its real name; the README still says
`dynamic-ci-filter`, which only resolves through GitHub's rename redirect), and
the merge queue is described as skipping nothing unless a paths filter is
configured for that lane, which is what the engine now does since the
merge-queue branch short-circuit was retired.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Sep 18, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
trunk 🟢 Ready View Preview Sep 18, 2026, 10:20 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant