Skip to content

Versioning Policy

Islandora 8 uses semantic versioning, except for Drupal modules/themes.

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 it's version.