Skip to content

docs(tailor): complete shipped CLI and workflow coverage - #850

Draft
Paco Huelsz (frhuelsz) wants to merge 7 commits into
user/frhuelsz/tailor-dependson-prerequisitesfrom
user/frhuelsz/tailor-docs-complete
Draft

Paco Huelsz (frhuelsz) wants to merge 7 commits into
user/frhuelsz/tailor-dependson-prerequisitesfrom
user/frhuelsz/tailor-docs-complete

Conversation

@frhuelsz

@frhuelsz Paco Huelsz (frhuelsz) commented Oct 13, 2026 •

Copy link
Copy Markdown
Collaborator

Complete Tailor’s shipped reference and practical guides, without the unfinished lock-preview workflow.

Correct dependency selection, overlapping-build safety, exact-cell examples, and the fragment-skip walkthrough. This docs layer follows #965 and documents its fixed dependsOn behavior.

Validated 78 YAML examples and relative links; exercised the revised skip walkthrough with Tailor’s matrix and dry-run commands. No application changes in this layer.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
1 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Workflow instructions still permit unsafe overlapping builds and contain verified selection and dependency-scheduling inaccuracies.

4 open findings
What changed in this PR

Updates Tailor documentation to reflect shipped CLI behavior and expand practical workflow guidance. No application code changes.

Changes:

  • Replaces lockfile guarantees with per-run resolution guidance.
  • Corrects CLI, YAML, runtime, and cleanup documentation.
  • Adds guides for dependencies, CI matrices, logging, artifacts, and rebuilding.
File Description
tools/​tailor/​README.md Updates feature and build summaries.
tools/​tailor/​docs/​tutorials/​your-first-matrix.md Corrects explain output.
tools/​tailor/​docs/​tutorials/​getting-started.md Completes scaffold and build instructions.
tools/​tailor/​docs/​reference/​tailor-yaml.md Clarifies runtime and toolchain settings.
tools/​tailor/​docs/​reference/​output-formats.md Clarifies artifact naming.
tools/​tailor/​docs/​reference/​image-yaml.md Expands image schema guidance.
tools/​tailor/​docs/​reference/​directives.md Documents field-specific merging.
tools/​tailor/​docs/​reference/​cli.md Corrects shipped command behavior.
tools/​tailor/​docs/​how-to/​use-a-local-ic-image.md Clarifies local-image resolution.
tools/​tailor/​docs/​how-to/​track-build-inputs.md Adds incremental-input guidance.
tools/​tailor/​docs/​how-to/​skip-experimental-cells.md Adds selective-skipping recipe.
tools/​tailor/​docs/​how-to/​sign-an-image.md Clarifies signing prerequisites.
tools/​tailor/​docs/​how-to/​set-the-build-directory.md Expands scratch safety guidance.
tools/​tailor/​docs/​how-to/​README.md Indexes new guides.
tools/​tailor/​docs/​how-to/​pin-the-ic-version.md Reframes toolchain tag selection.
tools/​tailor/​docs/​how-to/​override-a-base-per-axis.md Adds OCI preview opt-in.
tools/​tailor/​docs/​how-to/​manage-extracted-artifacts.md Explains extraction policies.
tools/​tailor/​docs/​how-to/​generate-a-ci-matrix.md Adds CI matrix guidance.
tools/​tailor/​docs/​how-to/​export-configs-for-a-pipeline.md Clarifies pipeline responsibilities.
tools/​tailor/​docs/​how-to/​cross-arch-building.md Adds OCI preview opt-in.
tools/​tailor/​docs/​how-to/​convert-an-image-format.md Corrects conversion scratch behavior.
tools/​tailor/​docs/​how-to/​clean-and-rebuild.md Documents cleanup and build locking.
tools/​tailor/​docs/​how-to/​capture-build-logs.md Adds logging configuration guidance.
tools/​tailor/​docs/​how-to/​build-with-an-azure-linux-base.md Clarifies per-run digest resolution.
tools/​tailor/​docs/​how-to/​build-dependent-images.md Adds producer-consumer recipes.
tools/​tailor/​docs/​explanation/​threat-model.md Revises registry identity guarantees.
tools/​tailor/​docs/​explanation/​merge-model.md Clarifies predicates and precedence.
tools/​tailor/​docs/​explanation/​design-rationale.md Updates resolution terminology.
tools/​tailor/​docs/​explanation/​crate-architecture.md Updates core responsibilities.
tools/​tailor/​docs/​explanation/​base-images.md Clarifies sources and hash caching.
tools/​tailor/​COMPATIBILITY.md Removes lockfile-format guidance.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Integrate the reviewed dependsOn prerequisite fix and address selection, concurrency, and fragment-skip examples.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@frhuelsz
Paco Huelsz (frhuelsz) changed the base branch from main to user/frhuelsz/tailor-dependson-prerequisites November 19, 2026 02:15

This branch has not been deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants