fix build (#101)

guide/sections/part2/global-services.adoc

@@ -109,8 +109,8 @@ In WIS2 Global Caches provide access to WMO Core Data for data consumers. This a
 ** A Cache management implementing the features needed to connect with the WIS ecosystem, receive data from WIS2 nodes and other Global Caches, store the data to the data server and manage the content of the cache (i.e. expiration of data, deduplication, etc)
 * The Global Cache will aim at containing copies of real-time and near real-time data designated as "core" within the WMO Unified Data Policy, Resolution 1 (Cg-Ext(2021)).
 * A Global Cache instance will host data objects copied from NC/DCPCs.
-* A Global Cache instance will publish notification messages advertising availability of the data objects it holds. The notification messages will follow the standard structure (see [TODO CROSSREF] <<notification-message-format-and-structure>>).
-* A Global Cache instance will use the standard topic structure in their local message brokers (see [TODO CROSSREF] <<standard-topic-hierarchy>>).
+* A Global Cache instance will publish notification messages advertising availability of the data objects it holds. The notification messages will follow the standard structure (see TODO CROSSREF <<notification-message-format-and-structure>>).
+* A Global Cache instance will use the standard topic structure in their local message brokers (see TODO CROSSREF <<standard-topic-hierarchy>>).
 * A Global Cache instance will publish on topic ``cache/a/wis2/...``.
 * There will be multiple Global Cache instances to ensure highly available, low latency global provision of real-time and near real-time "core" data within WIS2.
 * There will be multiple Global Cache instances may attempt to download cacheable data objects from all originating centres with "cacheable" content. A Global Cache instance will also download data objects from other Global Cache instances. This ensures the instance has full global coverage, mitigating where direct download from an originating centre is not possible.
@@ -129,9 +129,9 @@ In WIS2 Global Caches provide access to WMO Core Data for data consumers. This a
 
 * A Global Cache shall subscribe to at least two different Global Brokers.
 * A Global Cache shall subscribe to the topics `+origin/a/wis2/#+`, `+cache/a/wis2/#+`.
-* A Global Cache shall ignore all messages received on the topics `+origin/a/wis2/+/data/recommended/#+` and `+cache/a/wis2/+/data/recommended/#+` footnote:[It is also technically possible to filter recommended data by using a wildcard subscription such as `+origin/a/wis2/+/data/core/#+`. However, avoiding wildcard subscription is generally considered good practice as it limits the burden of the broker operated by Global Brokers.]
+* A Global Cache shall ignore all messages received on the topics `+origin/a/wis2/+/data/recommended/#+` and `+cache/a/wis2/+/data/recommended/#+` footnote:[It is also technically possible to filter recommended data by using a wildcard subscription such as `+origin/a/wis2/+/data/core/#+`. However, avoiding wildcard subscription is generally considered good practice as it limits the burden of the broker operated by Global Brokers.
 * A Global Cache shall retain the data and metadata they receive for a minimum period of 24 hours. Requirements relating varying retention times for different types of data may be added later.
-* For messages received on topic ``origin/a/+/data/core/#`` or ``cache/a/+/data/core/#`` a Global Cache shall:
+* For messages received on topic `+origin/a/+/data/core/#+` or `+cache/a/+/data/core/#+` a Global Cache shall:
 ** If the message contains the property ``"properties.cache": false``
 *** Republish the unmodified message at topic ``cache/a/wis2/...`` matching ``+/a/wis2/...`` where the original message has been received.
 ** else
@@ -198,7 +198,7 @@ wis2-gdc provides functionality required Global Discovery Catalogue, providing t
 * discovery metadata download the Global Cache
 * discovery metadata validation, ingest and publication
 * WCMP2 compliance
-* quality assessment (key performance indicators [TODO CROSSREF - WCMP2 KPIs])
+* quality assessment (key performance indicators TODO CROSSREF - WCMP2 KPIs)
 * OGC API - Records - Part 1: Core compliance
 * metrics reporting
 * implementation of metrics

guide/sections/part2/wis2-architecture.adoc

@@ -67,7 +67,7 @@ Leveraging existing open standards, WIS2 defines the following specifications in
 
 === Components of WIS2
 
-[TODO: add refs to other parts of the Guide describing these components]
+// TODO: add refs to other parts of the Guide describing these components
 
 ==== WIS2 Node
 * WIS2 Nodes are central to WIS2. These are operated by National Centres (NC) and Data Collection and Production Centres (DCPC) to publish their *Core* and *Recommended* data.