Role of the handbook

The Specification for SWIM Information Definition v1.0 sets out a number of requirements to be met by an information definition. It provides some basic examples to illustrate the requirements. However, the specification does not give exhaustive details on how to satisfy the requirements.

This handbook gives guidance to help information definition authors and AIRM conformance report authors to satisfy the requirements.

The guidance contained in the handbook promotes the creation of better information definitions. It will lead to greater harmonisation in the implementation of the specification.

Target audiences

• Information definition authors
• AIRM conformance report authors
• AIRM conformance report auditors and readers

Content structure

The handbook is organised into key topics.

Introduction to the specification. This introduces the purpose and context for the specification. It introduces semantic correspondence and semantic interoperability. It gives an overview of the requirements in the specification.

Guidance on the general requirements. This provides support in order to satisfy the general requirements contained in the specification.

Guidance on semantic correspondence. This provides support in order to satisfy the semantic correspondence requirements contained in the specification.

Resources. This provides examples, recommendations on how to satisfy the requirements in various formats and a verification checklist.

Full table of contents