The widgets will follow a subset of the SEMVER policy. The discrepancy being we will issue patches/bug fixes as well as enhancements under a minor version, not a patch version. In effect this means there are only two types of releases for a widget; breaking or non-breaking.
Releases are named according to a MAJOR.MINOR scheme, and only MAJOR versions releases may change or remove public APIs. MINOR versions may introduce new features so long as they are backwards compatible.
Major Versions – Breaking Changes
A major version bump means you should expect to make changes to any integration code. While we will do our best to keep breaking changes to a minimum, we will at times be required to change the public API, remove old features, etc.
What Constitutes a Breaking Change?
- Removal of a previously supported public API e.g. removing a configuration option from a widget.
- Removal of a feature e.g. removing zip code pickers from weather widgets.
- Removal of an underlying data feed.
Minor Versions – Non-Breaking Changes
A bump Non-breaking changes mean we have not introduced any backwards-incompatible changes to the widget’s public API. These releases can be adopted without requiring code-changes.
What Constitutes a Non-Breaking Change?
- A bug fix e.g. fixing a css display issue
- Adding a new feature e.g. adding more layers to the Interactive Map Widget.