ReleaseProcess

WIS2 Topic Hierarchy Release Process

Overview

The WIS2 Topic Hierarchy is managed in GitHub as a working area upstream of the WMO publication process.

Release version convention

The convention used is x.y.z, where x.y.z is the version (e.g. 1.0.0)

Steps

The following steps are taken when creating a WIS2 Topic Hierarchy release:

1. Update release version in main branch

• Edit standard/index.adoc
  • update the :version: tag/marker
  • update the ©️ tag/marker (i.e. 2024-2025, 2024-2026, etc.)
• Commit to main branch
  • git commit -m 'update release version x.y.z' standard/index.adoc

2. Create release tag

git tag -a x.y.z -m 'tagging release x.y.z'
git push --tags

3. Create release zip

# build specification document
cd standard
make pdf
cd ..
# build bundle
python3 scripts/generate-bundle.py
zip -j /tmp/wis2-topic-hierarchy-x.y.z-bundle.zip topic-hierarchy/*.csv
# setup release
mkdir -p release/x.y.z
cd release/x.y.z
mkdir standard bundle
cd ../..
cp /tmp/wis2-topic-hierarchy-x.y.z-bundle.zip release/x.y.z/bundle/wis2-topic-hierarchy-x.y.z-bundle.zip
cp standard/wis2-topic-hierarchy.pdf release/x.y.z/standard/wis2-topic-hierarchy-x.y.z.pdf
cd release
zip -r wis2-topic-hierarchy-x.y.z.zip x.y.z

4. Deploy release on schemas.wmo.int server

• copy zipfile to server
• cd to directory corresponding to https://schemas.wmo.int/wth
• run unzip wth-x.y.z.zip

5. Create a release on GitHub.

• Go to https://github.com/wmo-im/wis2-topic-hierarchy/releases
• Click 'Draft a new release'
• Under 'Tag Version' add the relevant release tag (x.y.z)
• Release title should be x.y.z
• TODO: add release description
• Click 'Publish release'
• Send WMO Secretariat a link to the release

Managing latest updates (a)

WTH a always represents the latest approved standard, as well as immediate updates to centre identifiers. The below describes how to manage WTH a releases.

On any release of WTH

1. Deploy release on schemas.wmo.int server

• copy latest WTH x.y.z zipfile to server
• cd to directory corresponding to https://schemas.wmo.int/wth/a
• run unzip wth-x.y.z.zip

On centre identifier updates

1. Deploy zipfile bundle release https://wmo-im.github.io/wis2-topic-hierarchy/wth-bundle.zip on schemas.wmo.int server

• copy zipfile to server, in directory corresponding to https://schemas.wmo.int/wth/a/bundle/wis2-topic-hierarchy-bundle-a.zip