Semantic versioning policy

We follow semantic versioning. However, due to the nature of stylelint as a code quality tool, we've defined the following policy for stylelint:

• patch release (intended to not break your lint build)

  • a bug fix in a rule that results in stylelint reporting fewer errors
  • a bug fix to the CLI or core (including formatters)
  • improvements to documentation.
  • non-user-facing changes such as refactoring code or modifying tests
  • re-releasing after a failed release (i.e., publishing a release that doesn't work for anyone)

• minor release (might break your lint build)

  • a bug fix in a rule that results in stylelint reporting more errors
  • a new rule is created
  • a new option to an existing rule that does not result in stylelint reporting more errors by default
  • an existing rule is deprecated
  • a new CLI capability is created
  • a new public API capability is created
  • a new formatter is created

• major release (likely to break your lint build)

  • a change in the documented behaviour of an existing rule results in stylelint reporting more errors by default
  • an existing rule is removed
  • an existing formatter is removed
  • part of the a CLI is removed or changed in an incompatible way
  • part of the public API is removed or changed in an incompatible way