diff --git a/standard/wis2-topic-hierarchy-DRAFT.docx b/standard/wis2-topic-hierarchy-DRAFT.docx index d39b203..eef3ba7 100644 Binary files a/standard/wis2-topic-hierarchy-DRAFT.docx and b/standard/wis2-topic-hierarchy-DRAFT.docx differ diff --git a/standard/wis2-topic-hierarchy-DRAFT.html b/standard/wis2-topic-hierarchy-DRAFT.html index 2751635..23e1c9a 100644 --- a/standard/wis2-topic-hierarchy-DRAFT.html +++ b/standard/wis2-topic-hierarchy-DRAFT.html @@ -623,6 +623,9 @@

3. References

International Telecommunications Union (ITU): T.50 : International Reference Alphabet (IRA) (Formerly International Alphabet No. 5 or IA5) - Information technology - 7-bit coded character set for information interchange [9]

+
  • +

    IANA: Root Zone Database (2023) [10]

    +
  • @@ -703,6 +706,14 @@

    4.1

    Publish / Subscribe

    +

    PR

    +

    Permanent Representative

    + + +

    TLD

    +

    Top-level domain

    + +

    URI

    Uniform Resource Identifier

    @@ -797,10 +808,10 @@

    6.4. Structure

    The structure of the topic hierarchy underpins the discovery and sharing of data in WIS, and requires standardization across all WIS services to provide consistent filter and access to the user.

    -

    Recalling that WIS is designed to support the WMO Unified Data Policy, the topic hierarchy must be aligned with WMO Res. 1 Cg-EXT-21 - Unified Data Policy.:[10]

    +

    Recalling that WIS is designed to support the WMO Unified Data Policy, the topic hierarchy must be aligned with WMO Res. 1 Cg-EXT-21 - Unified Data Policy[11].

    -

    Final approval of the WTH updates will go through the WMO fast-track amendment process.[11]

    +

    Final approval of the WTH updates will go through the WMO fast-track amendment process.[12]

    @@ -863,10 +874,10 @@

    7.1.2. Management
    1. -

      Primary topic levels (levels 1-8): topic structure applies to all data and services in WIS

      +

      Primary topic levels (levels 1-7): topic structure applies to all data and services in WIS

    2. -

      Domain specific topic subcategory levels (level 9 and beyond): topic structure proposed by domain experts and user communities. Note that the number of levels in this part may vary according to the requirements of various domains.

      +

      Domain specific topic subcategory levels (level 8 and beyond): topic structure proposed by domain experts and user communities. Note that the number of levels in this part may vary according to the requirements of various domains.

    @@ -891,13 +902,13 @@

    7.1.2. Management

    B

    -

    Domain specific levels (level 9 and beyond) SHALL be determined by domain experts and user communities.

    +

    Domain specific levels (level 8 and beyond) SHALL be determined by domain experts and user communities.

    C

    -

    Domain specific levels (level 9 and beyond) SHALL be coordinated and integrated by the WMO Task Team on WIS Metadata.

    +

    Domain specific levels (level 8 and beyond) SHALL be coordinated and integrated by the WMO Task Team on WIS Metadata.

    @@ -917,14 +928,14 @@

    7.1.2. Management

    once consensus is reached, TT-WISMD approves the proposal for inclusion into the next release of WTH

  • -

    Final approval of the WTH updates will go through the WMO fast-track amendment process.[12]

    +

    Final approval of the WTH updates will go through the WMO fast-track amendment process.[13]


  • -
    @@ -987,7 +998,7 @@

    7.1.3. Versioning

    G

    -

    A renaming or removal in the WMO Notification Message Format SHALL result in a major version update.

    +

    A renaming or removal in the WMO Notification Message encoding SHALL result in a major version update.

    @@ -1031,7 +1042,7 @@

    7.1.4. Conv

    D

    -

    All topic level definitions SHALL utilize dashes (-).

    +

    All topic level definitions SHALL utilize dashes (-) to separate words (e.g. sea-ice).

    @@ -1050,7 +1061,119 @@

    7.1.4. Conv
    -

    7.1.5. Publishing guidelines

    +

    7.1.5. Centre identification

    +
    +

    The centre identifier (centre-id) is an acronym as specified by the member and endorsed by the PR of the country and WMO. It is a single identifier comprised of a TLD and centre name, and represents the data publisher, distributor or issuing centre of a given dataset or data product/granule.

    +
    + ++++ + + + + + + + + + + + + + + +

    Requirement 4

    +

    /req/core/centre-id

    +

    A

    +

    A centre identifier SHALL be formatted as tld-centre-name, where:

    +
    +
    +
      +
    • +

      tld is based on a TLD as defined by IANA[14]

      +
    • +
    • +

      centre-name is based on a centre name as defined by the member

      +
    • +
    +
    +

    B

    +

    The test TLD SHALL be used only for WIS internal system testing purposes.

    +
    + ++++ + + + + + + + + + + + + + + + + + + +

    Recommendation 5

    +

    /rec/core/centre-id

    +

    A

    +

    Organizations operating with a gov or similar TLD SHOULD use the TLD based on their country to define the TLD component of their centre identifier.

    +

    B

    +

    International organizations operating with a int, org or similar TLD SHOULD reuse these to define the TLD component of their centre identifier.

    +

    C

    +

    Organizations wishing to test their WIS2 Node or Global Service MAY provide the -test suffix to their centre identifier (e.g. int-org1-test).

    +
    + ++++ + + + + + + + + + + + + + + + + + + +

    Permission 6

    +

    /per/core/centre-id

    +

    A

    +

    A centre identifier’s centre-name component MAY contain dashes.

    +

    B

    +

    Larger organizations providing multiple centres MAY use dashes in the centre-name component to further delineate a centre function (e.g. int-org1-nwp, int-org1-ozone).

    +

    C

    +

    A centre providing a WIS service MAY further qualify the function within the centre-name component (e.g. int-org1-global-cache).

    +
    +
    +
    +

    7.1.6. Publishing guidelines

    For maximum utility and efficient management of topics, data, metadata, and reports need to be published to a minimum level. This helps with avoiding "pollution" of messages in higher level topics which are used to delineate core concepts (centre identification, notification types, data policy, etc.).

    @@ -1061,7 +1184,7 @@

    -

    Requirement 4

    +

    Requirement 7

    /req/core/publishing

    @@ -1093,7 +1216,7 @@

    -

    Permission 5

    +

    Permission 8

    /per/core/publishing

    @@ -1135,6 +1258,106 @@

    +

    A.1.1. Management

    +
    +

    This requirement is not applicable to ATS testing.

    +
    +

    +
    +

    A.1.2. Versioning

    +
    +

    This requirement is not applicable to ATS testing.

    +
    +
    +
    +

    A.1.3. Conventions

    +
    +
    +
    +
    +
    label
    +
    +

    /conf/core/conventions

    +
    +
    subject
    +
    +

    /req/core/conventions

    +
    +
    test-purpose
    +
    +

    Validate that a given topic meets the conventions of WTH.

    +
    +
    +
    +
    +
    +
    +
    +
    +

    Check that all characters in the topic are lowercase.

    +
    +
    +
    +
    +
    +
    +

    Check that all characters in the topic are based on ASCII T.50.

    +
    +
    +
    +
    +
    +
    +

    Check that no characters in the topic contain dots (.).

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +

    A.1.4. Centre identification

    +
    +
    +
    +
    +
    label
    +
    +

    /conf/core/centre-id

    +
    +
    subject
    +
    +

    /req/core/centre-id

    +
    +
    test-purpose
    +
    +

    Validate that a centre identifier is valid.

    +
    +
    +
    +
    +
    +
    +
    +
    +

    Check that the first component of the centre identifier is a valid TLD as defined by IANA[15].

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +

    A.1.5. Publishing guidelines

    +
    +

    This requirement is not applicable to ATS testing.

    +
    +
    @@ -1146,13 +1369,13 @@

    <
    Example: WIS Node data publishing (surface weather observations) from Environment and Climate Change Canada, Meteorological Service of Canada
    -
    origin/a/wis2/can/eccc-msc/data/core/weather/surface-based-observations/synop
    +
    origin/a/wis2/ca-eccc-msc/data/core/weather/surface-based-observations/synop
    Example: WIS Node metadata publishing from Deutscher Wetterdienst
    -
    cache/a/wis2/deu/dwd/metadata/core/wcmp2
    +
    cache/a/wis2/de-dwd/metadata/core/wcmp2
    @@ -1164,16 +1387,16 @@

    Annex C: Biblio
    • -

      OASIS: MQTT Version 5.0 (2019) [13]

      +

      OASIS: MQTT Version 5.0 (2019) [16]

    • -

      OASIS: MQTT Version 3.1.1 (2014) [14]

      +

      OASIS: MQTT Version 3.1.1 (2014) [17]

    • -

      Wikipedia: Publish-subscribe pattern (2023) [15]

      +

      Wikipedia: Publish-subscribe pattern (2023) [18]

    • -

      International Telecommunications Union (ITU): T.50 : International Reference Alphabet (IRA) (Formerly International Alphabet No. 5 or IA5) - Information technology - 7-bit coded character set for information interchange [16]

      +

      International Telecommunications Union (ITU): T.50 : International Reference Alphabet (IRA) (Formerly International Alphabet No. 5 or IA5) - Information technology - 7-bit coded character set for information interchange [19]

    @@ -1242,27 +1465,33 @@

    Annex 9. https://www.itu.int/rec/T-REC-T.50 - - diff --git a/standard/wis2-topic-hierarchy-DRAFT.pdf b/standard/wis2-topic-hierarchy-DRAFT.pdf index 4e03ab1..2c799c2 100644 Binary files a/standard/wis2-topic-hierarchy-DRAFT.pdf and b/standard/wis2-topic-hierarchy-DRAFT.pdf differ