Skip to content

Teach independent versions with graphs, the three sets, and the PR loop - #146

Merged
russwyte merged 1 commit into
mainfrom
docs/independent-versions-thorough
Aug 29, 2026
Merged

Teach independent versions with graphs, the three sets, and the PR loop#146
russwyte merged 1 commit into
mainfrom
docs/independent-versions-thorough

Conversation

@russwyte

Copy link
Copy Markdown
Contributor

The first Independent versions page was a thin YAML dump. This is the teaching page the feature needed.

What the site walks

  • Feature flag: lockstep v* vs Ship rows
  • Everyday loop: PR, sticky comment, fail-closed check, human writes the number, merge, modver array, Graph publish
  • Monorepo graph: ShipGroup libs vs Ship client vs unpublished service
  • Catalog rows, local -ci vs POM number, bump hunk
  • Three sets: Affected fail-open vs bump vs publish (fail-closed), including group lift
  • Library vs image (merge vs human v* tag)
  • ZipxModver.publish skip-tolerance
  • Propagate (Never / PatchPublished / MatchBump)
  • CacheEpoch.ShipCatalog
  • Matrix root (Ship("core") covers coreJS)
  • What generate refuses
  • Adopt recipe

Pointers from Why zipx, Quick start, and Validation.

Proof

docs/testFull (104). scalafmtCheckAll. Previewed at /independent-versions.html.

The first Independent versions page was a thin YAML dump. The site page now
walks the everyday loop, the monorepo graph, group lift vs Affected, library
vs image, ZipxModver skip-tolerance, propagate, matrix roots, and generate
refusals, each with mermaid and example-locked renders.
@russwyte
russwyte merged commit d75f890 into main Aug 29, 2026
8 checks passed
@russwyte
russwyte deleted the docs/independent-versions-thorough branch August 29, 2026 00:04
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