Change Management

WIS2 Topic Hierarchy change management

<<< DRAFT >>>

Overview

This is a working document to help provide clarity and guidance on how the Level 9+ vocabularies will be developed and approved.

The WIS2 Topic Hierarchy (WTH) is managed by the WMO Task Team on WIS Metadata (TT-WISMD). Updates to the WTH are made as part of two workflows: core levels, and domain specific vocabularies.

Updating core levels

WTH core levels (1-8) are managed by TT-WISMD via the established procedures of the TT.

Updating domain specific levels

WTH domain specific vocabularies (level 9 and beyond) are determined by various teams familiar with the given domain and integrated using the below steps:

1. Level 9+ domain specific vocabularies are developed outside this GitHub repository as determined by a given domain specific team/activity. Examples include (but are not limited to) Word documents, spreadsheets, or in a separate GitHub repository. If the team is using GitHub, then it is recommended to fork this repository as it will enable the domain specific team to be consistent with the approaches in place and stay up to date with other modifications
2. The domain specific team submits an issue to the WTH issue tracker to create/update their domain specific vocabulary using the WTH proposal issue template (TODO: create issue template)
3. The TT-WISMD will review the proposal and curate the content in branches of this repository in preparation for publication. The branch in this repository may be updated with the new vocabularies manually or with a pull request from the forked repository
4. Approval of the codes will go through the WMO fast-track procedure which occurs 2x year. See https://community.wmo.int/en/activity-areas/wis/amendment-processes-wis-manuals-and-guides for details

Domain specific vocabulary teams

Name	Sub-discipline	Relative group
weather	predictions	TT-NWPMD, (?)
weather	advisories-warnings
climate
hydrology		TT-W2FH
atmospheric-composition		ET-ACDM
cryosphere
ocean
space-weather