Skip to content

docs: rewrite the docs for bake.yml and add a 3.x → 4.0.0 migration guide - #86

Draft
Ilyes512 wants to merge 3 commits into
4.0/hardeningfrom
4.0/docs
Draft

Ilyes512 wants to merge 3 commits into
4.0/hardeningfrom
4.0/docs

Conversation

@Ilyes512

@Ilyes512 Ilyes512 commented Nov 9, 2026 •

Copy link
Copy Markdown
Member
  • docs/bake.md replaces actions.md, php.md and go-cli.md. It covers vendoring specs.hcl, local builds, the CI variables, the functions, and complete examples for utils, php84 (3 flavours × 2 stages) and specs-cli (variants). All examples were checked with bake --print.
  • Rewritten: pipeline.md, workflows.md, testing-images.md and releasing.md. base-images.md gets link and wording fixes.
  • docs/migration-4.0.md: before/after, an input → HCL table, what was removed, what publishes differently (no v-prefixed tag, a semver set for every image, no title/description fallback), and the new required check image / Image.
  • The update-project prompt no longer bumps self-references.

Part of the 4.0.0 stack (bake variant of the plan in #80). Merge bottom to top: #82 → #83 → #84 → #85 → #86.

- docs/bake.md replaces actions.md, php.md and go-cli.md: the consumer's
  docker-bake.hcl, the variables CI sets, the specs.hcl functions, and
  complete examples for a plain image, a PHP image and a Go CLI with
  variants.
- pipeline.md describes plan, build, publish and status, and the frozen
  definition; workflows.md documents bake.yml and the changed
  notify-slack-tag.yml; testing-images.md uses docker/bake-action with
  load: true; releasing.md drops the internal reference bump and
  explains SPECS_HCL_SHA256.
- docs/migration-4.0.md has the before and after of a consumer's
  workflow, the mapping from every old input to HCL, what was removed,
  what publishes differently, and the new required check.
- The update-project prompt no longer bumps self-references, since there
  are none left.
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.

1 participant