Major vs minor vs patch release

If the current package version is

  • Increment patch, e.g. 0.8.2 for a patch release:
    • You’ve fixed bugs
    • You haven’t added any significant new features
    • There are no breaking changes
  • Increment minor, e.g. 0.9.0, for a minor release:
    • Include bug fixes
    • New features
    • Backward compatible changes
  • Increment major, e.g. 1.0.0, for a major release:
    • Add braking changes
    • From a marketing perspective, save important new features for a major release.
    • 1.0.0 indicates that your package is feature complete with a stable API.

Minor and major release should share the good news in blog posts.