TOSCA V1.1: Variants of Collections of Specs

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

2. Spec Structure – Variant A TOSCA Simple Profile YAML - By Example - YAML Grammar - “XML  YAML” - Missing XML Gen - “YAML  XML” TOSCA V1.1 XML - Simple Profile • 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

3. Spec Structure – Variant B TOSCA Simple Profile YAML - By Example - Simple Profile Definition - Including “XML-like” Rules - YAML Grammar - “XML  YAML” - Missing XML Gen - “YAML  XML” - XML Examples TOSCA V1.1 XML • 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 (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 TOSCA V1.1 XML • Simple Profile is a separate document TOSCA Simple Profile YAML - By Example - YAML Grammar - “XML  YAML” - Missing XML Gen - “YAML  XML” TOSCA Simple Profile 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.