Version
This page concerns v2.0 of the Specification. Supporting material on v1.0 is <tbd>
Requirement
Title | Service abstract |
Identifier | SWIM-SERV-050 |
Requirement | A service description shall include a short textual description summarising the service. |
Rationale | A good abstract is valuable, in particular during service discovery. The abstract, by ensuring an understanding of the service, supports the decisions on whether the service is suitable for use in a particular situation. |
Verification | Completeness: Verify that the element is included. Consistency: Not Applicable. Correctness: Not Applicable. |
Examples/Notes | Note: It is best practice for the abstract to include the information domain(s) covered by the information service, the operational need being addressed by the information service, the intended use of the information service, and the intended consumer audience for the information service. |
Level of Implementation | Mandatory |
Guidance
To do
The expected content of the abstract should be made more explicit in the supporting material including the mapping to other fields. Based on the new best practice and expected service overview content
best practice for the abstract to include:
- the information domain(s) covered by the information service,
- the operational need being addressed by the information service,
- the intended use of the information service, and
- the intended consumer audience for the information service.