Working towards the next version of the SWIM Supporting Material

Page tree

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents

This section of the Guidance for JSON service descriptions handbook provides guidance on service description requirements that are not originating from the SWIM Service Description specification.

For each requirement, the supporting material is organised as:Each requirement is made available on a separate web page for easy referencing and linking.

Each requirement page includes on a single page all information to satisfy the requirement. That is

  • Requirement. The requirement 's table as from the original document. 
  • Guidance. Such as textual explanation, example(s), etc.

  • JSON Guidance. Guidance to fill in a JSON service description, including schema excerpt and example.table (with identifier, statement, rationale, etc)
  • Guidance. General guidance to satisfy the requirement, if any
  • JSON Guidance. JSON guidance to satisfy the requirement, with
    • Schema: excerpt of JSON Schema and applicable rule 
    • Guidance: Guidance for producing the relevant part(s) of a JSON service description  
    • Example: one or 2 corresponding examples in JSON

titleIntegrated guidance

This section goes beyond the Service Description specification. It covers requirements concerning service descriptions coming from other sources.

It allows service description authors to use the Service Description Handbook as the single entry point on guidance on JSON service descriptions.

Content of this section

List of other requirements for producing JSON service descriptions. 

Children Display