libreshop/shop
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

CHANGELOG + SemVer commitment + base image publishing strategy #9

New Issue
Closed
opened 2026-05-04 15:42:19 +02:00 by libretech · 1 comment
libretech commented 2026-05-04 15:42:19 +02:00
Owner
Copy Link
Copy Source

Part of #2

Goal

Establish libreshop/shop as a publicly versioned base image with documented override surface and SemVer guarantees, so adapters (mp and future) can pin and migrate safely.

Acceptance

  • CHANGELOG.md in libreshop/shop with semver convention:
    • Major = breaking override surface (component renamed/removed, slot signature changed, frontmatter/composable shape changed, env-var rename)
    • Minor = additive (new components, new optional config)
    • Patch = bugfix
  • Each major release ships a migrations/vX-to-vY.md with concrete adapter migration steps (codemod scripts where feasible)
  • CI publishes git.librete.ch/libreshop/shop:vX.Y.Z + :vX + :latest on tag push (already configured for :vX.Y.Z; add semver moving tags)
  • Bare image is functional and deployable — running docker run libreshop/shop:vX.Y.Z produces a working demo shop with placeholder branding
  • README documents the public override surface (links to ls#4 outcome)
  • No further changes to internal components without major bump if they are part of the surface
Part of https://git.librete.ch/libreshop/shop/issues/2 ## Goal Establish libreshop/shop as a publicly versioned base image with documented override surface and SemVer guarantees, so adapters (mp and future) can pin and migrate safely. ## Acceptance - [ ] `CHANGELOG.md` in libreshop/shop with semver convention: - **Major** = breaking override surface (component renamed/removed, slot signature changed, frontmatter/composable shape changed, env-var rename) - **Minor** = additive (new components, new optional config) - **Patch** = bugfix - [ ] Each major release ships a `migrations/vX-to-vY.md` with concrete adapter migration steps (codemod scripts where feasible) - [ ] CI publishes `git.librete.ch/libreshop/shop:vX.Y.Z` + `:vX` + `:latest` on tag push (already configured for `:vX.Y.Z`; add semver moving tags) - [ ] Bare image is **functional and deployable** — running `docker run libreshop/shop:vX.Y.Z` produces a working demo shop with placeholder branding - [ ] README documents the public override surface (links to ls#4 outcome) - [ ] No further changes to internal components without major bump if they are part of the surface
libretech commented 2026-09-24 10:45:58 +02:00
Author
Owner
Copy Link
Copy Source

Folded into the single muellerprints.de tracker libretech/mp#50 during the 2026-09-24 cleanup: no activity since 2026-05-04. Reopen when work resumes.

Folded into the single muellerprints.de tracker https://git.librete.ch/libretech/mp/issues/50 during the 2026-09-24 cleanup: no activity since 2026-05-04. Reopen when work resumes.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
libretech (Michael Czechowski) libretech-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: libreshop/shop#9