Skip to content

docs(version): clarify breaking change rules for major version zero#4307

Merged
JamesHenry merged 1 commit intolerna:mainfrom
AI-JamesHenry-Org:4192
Mar 12, 2026
Merged

docs(version): clarify breaking change rules for major version zero#4307
JamesHenry merged 1 commit intolerna:mainfrom
AI-JamesHenry-Org:4192

Conversation

@AI-JamesHenry
Copy link
Copy Markdown
Collaborator

@AI-JamesHenry AI-JamesHenry commented Mar 12, 2026

Note

🤖 This PR was created by @AI-JamesHenry, an AI assistant account guided and overseen by @JamesHenry.

Summary

  • Rewrites the misleading "major version zero" note in the Fixed/Locked mode docs to accurately describe when version bumps are considered breaking
  • The previous note incorrectly stated that any non-prerelease bump with a major version zero would publish all packages
  • The actual behavior (per is-breaking-change.ts) is that only specific bumps are breaking: major bumps always, minor bumps when < 1.0.0, and patch bumps when < 0.1.0

Closes #4192

Test plan

  • Verify the updated note at website/docs/features/version-and-publish.md matches the logic in libs/commands/version/src/lib/is-breaking-change.ts
  • Confirm npm run format:check passes

The previous note incorrectly stated that choosing "any non-prerelease
version number" with a major version zero would publish all packages.
In reality, only specific bumps are considered breaking:

- Major bumps are always breaking
- Minor bumps are breaking when version < 1.0.0
- Patch bumps are breaking when version < 0.1.0

A regular patch bump (e.g. 0.6.38 → 0.6.39) is not breaking and will
only publish changed packages.

Closes lerna#4192
@nx-cloud
Copy link
Copy Markdown

nx-cloud bot commented Mar 12, 2026

View your CI Pipeline Execution ↗ for commit 23edabc

Command Status Duration Result
nx run-many --t e2e --parallel=1 ✅ Succeeded 4s View ↗
nx run-many -t lint --parallel=3 ✅ Succeeded 10s View ↗
nx run-many -t build ✅ Succeeded <1s View ↗
nx-cloud record -- npx nx format:check ✅ Succeeded 2s View ↗
nx run-many -t test --parallel=3 --ci --maxWork... ✅ Succeeded <1s View ↗
nx run integration:integration --ci --maxWorkers=2 ✅ Succeeded <1s View ↗
nx run-many -t build --parallel=3 ✅ Succeeded <1s View ↗
nx run-many -t test --parallel=3 --ci --maxWork... ✅ Succeeded 9s View ↗

☁️ Nx Cloud last updated this comment at 2026-03-12 11:59:12 UTC

@JamesHenry JamesHenry marked this pull request as ready for review March 12, 2026 12:01
@JamesHenry JamesHenry enabled auto-merge (squash) March 12, 2026 12:01
@JamesHenry JamesHenry merged commit f6421c3 into lerna:main Mar 12, 2026
15 checks passed
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.

"major version zero" behavior in docs is inaccurate

2 participants