1. TOSCA V1.1: Variants of Collections of Specs

2. Spec Structure – Variant A The XML Simple Profile is a subsetting of the V1.1 spec but compliant with the V1.1 XSD The “By Example” section primer-like explaining and motivating the usage of the language elements of the XML Simple Profile The YAML Grammar section formally defines the language elements of the YAML examples The Missing XML Generation sections specifies how to generate XML elements of the XML Simple Profile that are not needed in YAML – E.g. ServiceDefinition TOSCA V1.1 XML - Simple Profile TOSCA Simple Profile YAML - By Example - YAML Grammar - “XML  YAML” - Missing XML Gen - “YAML  XML”

3. Spec Structure – Variant B TOSCA V1.1 XML is the full specification – No separate “Simple Profile” section Simple Profile is defined in YAML Spec “only” – Requires to specify consistency rules repeating those in the V1.1 specification XML examples in the Simple Profile spec to bring simplicity to XML users too TOSCA V1.1 XML TOSCA Simple Profile YAML - By Example - Simple Profile Definition - Including “XML-like” Rules - YAML Grammar - “XML  YAML” - Missing XML Gen - “YAML  XML” - XML Examples (i) Consistency rule repeat content of the V1.1 Spec. (ii) To avoid a legacy impression for XML users, XML examples have to be given. Thus, variant A is preferred.

4. Spec Structure – Variant C Simple Profile is a separate document TOSCA V1.1 XML TOSCA Simple Profile YAML - By Example - YAML Grammar - “XML  YAML” - Missing XML Gen - “YAML  XML” TOSCA Simple Profile (i)Separate document to maintain (ii) Variant A gives editors freedom of choice how to define Simple Profile: for example “in place”, i.e. in the sections where the V1.1 language elements are defined (no separate Appendix needed). Thus, variant A is preferred. (i)Separate document to maintain (ii) Variant A gives editors freedom of choice how to define Simple Profile: for example “in place”, i.e. in the sections where the V1.1 language elements are defined (no separate Appendix needed). Thus, variant A is preferred.