Skip to content

Keep version numbers out of comments - #217

Merged
russwyte merged 1 commit into
mainfrom
comments/no-versions
Oct 5, 2026
Merged

russwyte merged 1 commit into
mainfrom
comments/no-versions

Conversation

@russwyte

@russwyte russwyte commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

A version in a comment drifts the moment the build moves. This removes them.

  • Example, fixture, and scripted-script comments describe the scenario. The commands and catalog files carry the numbers.
  • examples/monorepo/build.sbt drops the roadmap labels (Gap 1, Gap 2) as well.
  • The ImageTag snippet on the Packs page stated its outputs in comments. It is now four locked exampleValues, so the page shows what forCommit, branchCommit, and slug return.

Left as is: the # vX.Y.Z after a SHA in action pins (zipx parses and emits that annotation from the catalog, so it cannot drift), URLs, and the 0.y.0 pattern sbt's early-semver rule is stated in.

Proof: sbt "scalafmtAll; cleanFull; testFull" passes, plus plugin/scripted for catalog-wins, release-workflow, and mutual-snapshots.

A version in a comment drifts the moment the build moves. The fixture and
example comments now describe the scenario, and the commands and catalog
files carry the numbers. The ImageTag docs snippet that stated its outputs
in comments is now four locked examples, so the page shows what the calls
return.
@russwyte
russwyte merged commit de0ac62 into main Oct 5, 2026
13 checks passed
@russwyte
russwyte deleted the comments/no-versions branch October 5, 2026 15:55
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