Last modified by Artur on 2025/09/10 11:19

From version 2.4
edited by Helena
on 2025/06/16 15:47
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
... ... @@ -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.