Changes for page 14 ANNEX Semantic Versioning
Last modified by Helena on 2025/09/10 11:19
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 2 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -34,30 +34,27 @@ 34 34 35 35 == 14.3 Backus–Naur Form Grammar for Valid SDMX 3.0(.0) Semantic Versions == 36 36 37 +[[image:1747382317063-468.png]] 38 +[[image:1747382367401-937.png||height="321" width="637"]] 37 37 38 38 == 14.4 Dependency Management in SDMX 3.0(.0): == 39 39 40 40 MAJOR, MINOR or PATCH version parts in SDMX 3.0 artefact references CAN be wildcarded using "+" as extension: 41 41 42 -* X+.Y.Z means the currently latest available version >= X.Y.Z o Example: "2+.3.1" means the currently latest available version >= 43 - 44 -"2.3.1" (even if not backwards compatible) o Typical use case: references in SDMX Categorisations 45 - 46 -* X.Y+.Z means the currently latest available backwards compatible version >= 47 - 48 -X.Y.Z o Example: "2.3+.1" means the currently latest available version >= "2.3.1" and < "3.0.0" (all backwards compatible versions >= 49 - 50 -"2.3.1") o Typical use case: references in SDMX DSD 51 - 52 -* X.Y.Z+ means the currently latest available forwards and backwards compatible version >= X.Y.Z o Example: "2.3.1+" means the currently latest available version >= "2.3.1" and < "2.4.0" (all forwards and backwards compatible versions >= "2.3.1") 44 +* X+.Y.Z means the currently latest available version >= X.Y.Z 45 +** Example: "2+.3.1" means the currently latest available version >="2.3.1" (even if not backwards compatible) 46 +** Typical use case: references in SDMX Categorisations 47 +* X.Y+.Z means the currently latest available backwards compatible version >=X.Y.Z 48 +** Example: "2.3+.1" means the currently latest available version >= "2.3.1" and < "3.0.0" (all backwards compatible versions >="2.3.1") 49 +** Typical use case: references in SDMX DSD 50 +* X.Y.Z+ means the currently latest available forwards and backwards compatible version >= X.Y.Z 51 +** Example: "2.3.1+" means the currently latest available version >= "2.3.1" and < "2.4.0" (all forwards and backwards compatible versions >= "2.3.1") 53 53 * Non-versioned and 2-digit version SDMX structural artefacts CAN reference any other non-versioned or versioned (whether SemVer or not) SDMX structural artefacts. 54 54 * Semantically versioned artefacts MUST only reference other semantically versioned artefacts. 55 55 * Wildcarded references in a stable artefact implicitly target only future stable versions of the referenced artefacts within the defined wildcard scope. 56 -** Example: The reference to "AGENCY_ID:CODELIST_ID(2.3+.1)" in an artefact "AGENCY_ID:DSD_ID(2.2.1)" resolves to artefact 57 - 58 -"AGENCY_ID:CODELIST_ID(2.4.3)" if that was currently the latest available stable version. 59 - 60 -* Wildcarded references in a version-extended artefact implicitly target future stable and version-extended versions of the referenced artefacts within the defined wildcard scope. o Example: The reference to "AGENCY_ID:CODELIST_ID(2.3+.1)" in an artefact "AGENCY_ID:DSD_ID(2.2.1-draft)" resolves to artefact "AGENCY_ID:CODELIST_ID(2.5.0-draft)" if that was currently the latest available version. 55 +** Example: The reference to "AGENCY_ID:CODELIST_ID(2.3+.1)" in an artefact "AGENCY_ID:DSD_ID(2.2.1)" resolves to artefact "AGENCY_ID:CODELIST_ID(2.4.3)" if that was currently the latest available stable version. 56 +* Wildcarded references in a version-extended artefact implicitly target future stable and version-extended versions of the referenced artefacts within the defined wildcard scope. 57 +** Example: The reference to "AGENCY_ID:CODELIST_ID(2.3+.1)" in an artefact "AGENCY_ID:DSD_ID(2.2.1-draft)" resolves to artefact "AGENCY_ID:CODELIST_ID(2.5.0-draft)" if that was currently the latest available version. 61 61 * References to specific version-extended artefacts MAY be used, but those cannot be combined with a wildcard. 62 62 ** Example: The reference to "AGENCY_ID:CODELIST_ID(2.5.0draft)" in an artefact "AGENCY_ID:DSD_ID(2.2.1)" resolves to artefact "AGENCY_ID:CODELIST_ID(2.5.0-draft)", which might be subject to continued backwards compatible changes. 63 63
- 1747382317063-468.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +57.9 KB - Content
- 1747382367401-937.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.helena - Size
-
... ... @@ -1,0 +1,1 @@ 1 +27.6 KB - Content