TOSCA YAML v1.2 bugs and recommendation changes

["Nguyenphu, Thinh (Nokia - US/Irving)" <thinh.nguyenphu@nokia.com>]

Hello Chris and Claude,

 

I may be able to attend today YAML call, due to my traveling.  Anyway, I would like to report to YAML team a list of bugs and recommendation of changes (ref: version 1.2), would you please add to do list for fix version 1.2:

 

1. Section 3.6.9.5: entry schema is required for collection types
   1. Recommend to have “entry_schema” as required properties
2. Section 3.6.11.3:  “entry_schema” definition (gray box) is missing or not consistence with above table. Recommendation: add entry_schema to the defintion
3. Section 3.6.11.3:  the entry schema is required for collection types when the attribute does not have a corresponding property. Recommendation: to have “entry_schema” as required for attribute.
4. Section 3.6.15.2.1: the inputs should be <property_assignments>. Recommendation: update the section to illustrate property_assignments: (in the gray boxes).
5. Section 3.6.17: one of the two:
   1. requirement and capability can not be defined simulatanously (preferred)
   2. both requirement and capability must match the trigger
6. Section 3.6.18.1:is the event_type required or optional (the text and table contradict each other): Recommendation: update the table and definition to show required (yes).
7. Section 3.6.18.1: the type of the condition is not consistent (object [specified in short and extended notations] or list [ specified in keynames ] ). Recommendation:  “condition:    <list_of_condition_clause_definition>”.
8. Section 3.6.18.3.1: the example in the short notation should be event_type: instead of event:. Recommendation: change to event_type.
9. Section 3.7.2.2.2: the occurrences is missing from extended notation. Recommendation: add “occurrences” the definition.
10. Section 3.7.7.2: the derived_from is required for except the "root capability".
11. Section 3.8.2.1:
    1. occurrences is missing from the first table. Recommendation: update the table
    2. interfaces is missing from the second table. Recommendation: update the table
12. Section 3.8.2.2.3:
    1. the definition of the capability_symbolic_name is not consistent with 3.8.2.1 (the " ordered list of specific, " should be removed from the sentence.
    2. Please interpret this of give an example.  interface_assignments: represents the optional list of interface definitions for the declared relationship used to provide property assignments on inputs of interfaces and operations.
13. Section 4.4.2.2: If the get_property contains more than two parameters, than the resolution of the parameters is the not defined.
14. Section 5.5.3.2: the shortname is not a possible attribute
15. Section 5.8.5.1: duplicate description property
16. Section 5.9.3.3: rename tosca.nodes.BlockStorage to tosca.nodes.Storage.BlockStorage
17. Section 5.9.10.2 add two space before maxsize
18. Section 5.9.13: rename tosca.capabilities.EndPoint to tosca.capabilities.Endpoint
19. Section 5.9.14.1: the requirement section can not have a description property (see. 3.7.3 ).
20. Section 11.1.7.3 rename tosca.nodes.BlockStorage to tosca.nodes.Storage.BlockStorage
21. Section 11.1.8.3: rename tosca.nodes.BlockStorage to tosca.nodes.Storage.BlockStorage
22. Section 11.1.9.3: rename tosca.nodes.BlockStorage to tosca.nodes.Storage.BlockStorage

 

 

Thinh Nguyenphu

Nokia Networks

thinh.nguyenphu@nokia.com

+1 817-313-5189