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:

• Alpaca
• Chullo
• Crayfish
• Crayfish Commons
• Syn

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:

• carapace
• controlled_access_terms
• drupal-project
• islandora
• islandora_defaults
• jsonld
• openseadragon

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.