Versioning Policy¶
Islandora 8 uses semantic versioning, except for Drupal modules/themes, which use Drupal Contrib versioning.
Semantic Versioning¶
Major version . Minor version . Patch
- Major version; Major changes, and breaks the API
- Minor version; New features, and does not break the API
- Patch; Bug fixes, and never breaks backward compatibility
Examples:
1.2.3 => 1.2.4
- Just a bug fix, should be a drop-in replacement.1.2.3 => 1.3.0
- Adds in new features, should be a drop-in replacement to get new functionality.1.2.3 => 2.0.0
- Major changes, may require a migration or changes to your set-up.
The following Islandora 8 components use semantic versioning:
Drupal Contrib Versioning¶
Core Compatibility - Major . PatchLevel[-Extra]
Examples:
8.x-1.0 => 8.x-1.1
- Just a bug fix, should be a drop-in replacement.8.x-1.0 => 8.x-2.0
- Major changes, could require a migration or changes to your set-up.
The 8.x-
part will not change to 9.x-
until Drupal 9.
The following Islandora 8 components use Drupal Contrib versioning:
This list does not include sub-modules which share versions with their parents.
ie. Islandora Audio, Islandora IIIF and Islandora Breadcrumbs are all sub-modules of Islandora and shares its version.