Missing definition of Service and Profile on technology-neutral level

[mjacoby]

The technology-neutral API definition mentions the concept of Service in this figure

and also references the concept of profiles via the return type of the GetSelfDescription operation.

However, Services are never defined - only ServiceSpecifications which are the technology-specific version of it. Furthermore, the concept of Profile is not defined in the technology-neutral part of the specification and instead is only define in the HTTP/REST section.

Solution

• Clearly define those concepts in the technology-neutral section
• check if it makes sense to even have both technology-neutral and technology-specific definitions of those or if one technology-neutral definition is enough. If this is the case, rewrite the spec accordingly and adjust the figures

[BirgitBoss]

There are two solutions to it:

• update Figure 1 with profiles for technolcogy neutral and technology specific + add all profiles of http section to technology-neutral sections
• remove GetSelfDescription from technology neutral specification and add in http section only. Update Figure 1 with technology specific concept of "profiles"