wmo-im / iwxxm-codelists

Code list management for WMO published content
0 stars 6 forks source link

RDF representation is needed for operation #10

Open amilan17 opened 3 years ago

amilan17 commented 3 years ago

It would be helpful for users to have RDF file during the when the amendments are available for during FT reviews.

blchoy commented 3 years ago

This issue is raised to remind us what we should do with RDF exports of the code tables IWXXM is making reference to.

It is by design that in addition to schemas, schematron rules will also be used to validate IWXXM instances. This include correctness of code list entries, like http://codes.wmo.int/306/4678/BLDU, being specified in instances. In fact, it is an ICAO requirement for all IWXXM reports to pass validation before they can be disseminated by the producers.

As the registry is not expected to be used for online machine checking, the schematron rules in iwxxm.sch expects RDF exports of code tables to be present in the same sub-directory during execution. While iwxxm.sch resides on schemas.wmo.int (e.g. http://schemas.wmo.int/iwxxm/3.0/rule/iwxxm.sch), one will not find RDF exports in the same sub-directory, as it is a decision of the team to force the users to get the latest version of the RDF exports from the registry as they could have been updated since the publication of the schema/schematron rules. There is a Python script for this purpose on the IWXXM repository at https://github.com/wmo-im/iwxxm/blob/master/bin/codeListsToSchematron.py.

When submit a new version of IWXXM for FT approval, apart from the paper documents, we will be uploading an IWXXM Release Candidate to schemas.wmo.int (e.g. IWXXM 3.1RC1) for the WMO Members to try out. In this Release Candidate we will provide RDF exports as the code tables involved may not be in the operational registry. Since the team will now be also responsible for updating the code tables we own, proposals for changing the code tables will also be submitted in the same FT.

As soon as the FT gets approved, finalized schemas and schematrons will be uploaded to schemas.wmo.int and RDF exports will no longer be provided as mentioned above.

@jkorosi mentioned that it may be useful to have a snapshot of the RDF exports during the publication of a finalized version of IWXXM. I think this is a fair enough request, but we will need to think of a suitable location for this. Suggestions are most welcomed.