Skip to Content
Last modified by Artur on 2025/09/10 11:19
From version 3.1
edited by Helena
on 2025/06/16 15:48
Change comment: There is no comment for this version
To version 2.3
edited by Helena
on 2025/06/16 15:46
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -51,24 +51,24 @@
51 51  
52 52  MAJOR, MINOR or PATCH (% style="color:#e74c3c" %)version(%%) parts in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] 3.0 [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] references CAN be wildcarded using "+" as extension:
53 53  
54 -* X+.Y.Z means the currently latest available version >= X.Y.Z
55 -** Example: "2+.3.1" means the currently latest available version >="2.3.1" (even if not backwards compatible)
54 +* X+.Y.Z means the currently latest available (% style="color:#e74c3c" %)version(%%) >= X.Y.Z
55 +** Example: "2+.3.1" means the currently latest available (% style="color:#e74c3c" %)version(%%) >="2.3.1" (even if not backwards compatible)
56 56  ** Typical use case: references in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] Categorisations
57 -* X.Y+.Z means the currently latest available backwards compatible version >=X.Y.Z
58 -** Example: "2.3+.1" means the currently latest available version >= "2.3.1" and < "3.0.0" (all backwards compatible versions >="2.3.1")
57 +* X.Y+.Z means the currently latest available backwards compatible (% style="color:#e74c3c" %)version(%%) >=X.Y.Z
58 +** Example: "2.3+.1" means the currently latest available (% style="color:#e74c3c" %)version(%%) >= "2.3.1" and < "3.0.0" (all backwards compatible (% style="color:#e74c3c" %)versions(%%) >="2.3.1")
59 59  ** Typical use case: references in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] DSD
60 60  
61 -* 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")
61 +* X.Y.Z+ means the currently latest available forwards and backwards compatible (% style="color:#e74c3c" %)version(%%) >= X.Y.Z o Example: "2.3.1+" means the currently latest available (% style="color:#e74c3c" %)version(%%) >= "2.3.1" and < "2.4.0" (all forwards and backwards compatible (% style="color:#e74c3c" %)versions(%%) >= "2.3.1")
62 62  * Non-versioned and 2-digit (% style="color:#e74c3c" %)version(%%) [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] structural [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] CAN reference any other non-versioned or versioned (whether SemVer or not) [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] structural [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]].
63 63  * Semantically versioned [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] MUST only reference other semantically versioned [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]].
64 64  * Wildcarded references in a stable [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] implicitly target only future stable (% style="color:#e74c3c" %)versions(%%) of the referenced [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] within the defined wildcard scope.
65 65  ** Example: The reference to "AGENCY_ID:CODELIST_ID(2.3+.1)" in an [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] "AGENCY_ID:DSD_ID(2.2.1)" resolves to [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] "AGENCY_ID:CODELIST_ID(2.4.3)" if that was currently the latest available stable (% style="color:#e74c3c" %)version(%%).
66 -* Wildcarded references in a version-extended artefact implicitly target future stable and version-extended versions of the referenced [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] within the defined wildcard scope.
66 +* Wildcarded references in a (% style="color:#e74c3c" %)version(%%)-extended [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] implicitly target future stable and (% style="color:#e74c3c" %)version(%%)-extended (% style="color:#e74c3c" %)versions(%%) of the referenced [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] within the defined wildcard scope.
67 67  ** Example: The reference to "AGENCY_ID:CODELIST_ID(2.3+.1)" in an [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] "AGENCY_ID:DSD_ID(2.2.1-draft)" resolves to [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] "AGENCY_ID:CODELIST_ID(2.5.0-draft)" if that was currently the latest available (% style="color:#e74c3c" %)version(%%).
68 -* References to specific version-extended [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] MAY be used, but those cannot be combined with a wildcard.
68 +* References to specific (% style="color:#e74c3c" %)version(%%)-extended [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]] MAY be used, but those cannot be combined with a wildcard.
69 69  ** Example: The reference to "AGENCY_ID:CODELIST_ID(2.5.0draft)" in an [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] "AGENCY_ID:DSD_ID(2.2.1)" resolves to [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] "AGENCY_ID:CODELIST_ID(2.5.0-draft)", which might be subject to continued backwards compatible changes.
70 70  
71 -Because both, wildcarded references and references to version-extended [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]], allow for changes in the referenced [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]], care needs to be taken when choosing the appropriate references in order to achieve the required limitation in the allowed scope of changes.
71 +Because both, wildcarded references and references to (% style="color:#e74c3c" %)version(%%)-extended [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]], allow for changes in the referenced [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]], care needs to be taken when choosing the appropriate references in order to achieve the required limitation in the allowed scope of changes.
72 72  
73 73  For references to non-dependent [[artefacts>>doc:sdmx:Glossary.Artefact.WebHome]], MAJOR, MINOR or PATCH (% style="color:#e74c3c" %)version(%%) parts in [[SDMX>>doc:sdmx:Glossary.Statistical data and metadata exchange.WebHome]] 3.0 [[artefact>>doc:sdmx:Glossary.Artefact.WebHome]] references CAN alternatively be wildcarded using "*" as replacement:
74 74