add recipe for WNM validation

cookbook/index.adoc

@@ -35,8 +35,8 @@ toc::[]
 
 include::sections/introduction.adoc[]
 
-include::sections/data-consumers/index.adoc[]
+include::sections/data-consumers.adoc[]
 
-include::sections/data-publishers/index.adoc[]
+include::sections/data-publishers.adoc[]
 
-include::sections/global-service-operators/*.adoc[]
+include::sections/global-service-operators.adoc[]

cookbook/sections/data-publishers.adoc

@@ -0,0 +1,36 @@
+== Recipes for data publishers
+
+=== Validate a WIS2 Notification Message
+
+A https://wmo-im.github.io/wis2-notification-message[WIS2 Notification Message] provides a http://schemas.wmo.int/wnm[JSON Schema] which can be used by any progreamming language that supports JSON and JSON Schema validation.
+
+.Using Python and check-jsonschema
+[source,bash]
+----
+# install check-jsonschema Python Package from the Python Package Index (PyPI)
+pip3 install check-jsonschema
+
+# download WNM schema
+curl -O http://schemas.wmo.int/wnm/1.0.0/schemas/wis2-notification-message-bundled.json
+
+# run schema validation
+check-jsonschema --schemafile wis2-notification-message-bundled.json /path/to/my/wnm.json
+----
+
+The https://github.com/wmo-im/pywis-pubsub[pywis-pubsub] tool provides a test suite to validate a message against the WNM specification requirements, as well as a Python API for application integration.  Consult the pywis-pubsub README on GitHub for more information/examples.
+
+.Using pywis-pubsub
+[source,bash]
+----
+# install pywis-pubsub
+pip3 install pywis-pubsub
+
+# sync WIS2 notification schema
+pywis-pubsub schema sync
+
+# validate WNM against abstract test suite (file on disk)
+pywis-pubsub ets validate /path/to/file.json
+
+# validate WNM against abstract test suite (URL)
+pywis-pubsub ets validate https://example.org/path/to/file.json
+----

cookbook/sections/introduction.adoc

@@ -2,3 +2,5 @@
 === Purpose
 
 In conjunction with the Manual on the WMO Information System volume II (WMO-No. 1060) (Manual on WIS volume II: WIS 2.0), the present Guide to the WMO Information System volume II (Guide to WIS volume II: WIS 2.0) is designed to ensure adequate uniformity and standardization in the data, information and communication practices, procedures and specifications employed by Members of the World Meteorological Organization (WMO) in the operation of the WMO Information System WIS 2.0 as it supports the mission of the Organization. The Manual on WIS contains standard and recommended practices, procedures and specifications. The Guide to WIS contains additional information concerning practices, procedures, and specifications that Members are invited to follow or implement in establishing and conducting their arrangements in compliance with the WMO Technical Regulations and in developing meteorological and hydrological services.
+
+This cookbook provides various code snippets, recipes and workflow examples in support of WIS2 requirements.  This cookbook is a working document; contributions are encouraged and can be added via https://github.com/wmo-im/wis2-cookbook[GitHub].