Changes for page 14 ANNEX Semantic Versioning
Last modified by Artur on 2025/09/10 11:19
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -58,14 +58,14 @@ 58 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 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.