Skip to content

docs: formalize images/ independent versioning (middle ground before a repo split) - #550

Open
RonaldHensbergen wants to merge 1 commit into
mainfrom
docs/images-independent-versioning
Open

docs: formalize images/ independent versioning (middle ground before a repo split)#550
RonaldHensbergen wants to merge 1 commit into
mainfrom
docs/images-independent-versioning

Conversation

@RonaldHensbergen

Copy link
Copy Markdown
Owner

Closes #538.

Summary

Per discussion #530, this implements the "middle ground" @SemTiOne
preferred over a full repo split: keep images/** in this repo, but give
it an explicit CODEOWNERS boundary and formalize its already-existing
independent tag/release cadence.

  1. CODEOWNERS boundary — added an explicit /images/ entry to
    .github/CODEOWNERS (previously fell through to the repo-wide *
    default with no distinct line).
  2. Docs — added a "Versioning" section to docs/image-scanning.md
    stating that images are versioned independently of the CLI
    (pyproject.toml/CHANGELOG.md/vX.Y.Z tags cover the CLI only), that
    publish-images.yml's existing tag scheme (base version from
    dagster==/apache/superset:/dbt-core==, optional variant- prefix,
    plus sha-<12> and latest) is the authoritative release record for
    images, and that tests/fixtures/signed-images.json is where to look up
    the currently-published digest per image.

Explicitly out of scope (per issue)

  • No repo split.
  • No new GitHub Release objects/workflow for images.
  • No changes to publish-images.yml's tag computation itself.

Testing

  • npx --yes markdownlint-cli@0.49.0 "docs/image-scanning.md" — clean.
  • make lint — clean (pre-existing third-party .venv yamllint warnings
    only, unrelated to this change).

Adds an explicit /images/ CODEOWNERS entry and a Versioning section to
docs/image-scanning.md documenting the existing publish-images.yml tag
scheme as the authoritative release record for images, and pointing to
tests/fixtures/signed-images.json for currently-published digests.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

Give images/ independent versioning (middle ground before a repo split)

1 participant