Working towards the next version of the SWIM Supporting Material
Working towards the next version of the SWIM Supporting Material
The SWIM Service Description specification prescribes the minimum set of elements to be contained in a service description. It doesn't prescribe any format for the service description. Whatever the format, it is important to be able to satisfy the requirements.
This section of the handbook provides hints at template and schema that you can use to structure the content of service descriptions in various formats.
Identified formats
The Example service descriptions provides some example formats. It includes:
- web page
- Word document
- XML document
- JSON document
recommended format
The operational EUR SWIM Registry allows importing and exporting service descriptions in JSON format.
Guidance for JSON service descriptions v0.0.3d provide guidance for producing service descriptions in JSON format.
Definitions
area | description | comment |
---|---|---|
template | This is a structure that can be copied into documents such as Word documents and completed by the authors. | Benefits
|
schema | This is a structure that is used directly. An example could be an XML Schema. Authors create XML files that are validated against the XML Schema. | Additional benefit
|