oasis-tcs / tosca-specs

OASIS TOSCA TC: This repository contains drafts of the TOSCA TC’s specifications and committee notes. https://github.com/oasis-tcs/tosca-specs
Other
5 stars 5 forks source link

Unclear reference to TOSCA entities #160

Open pmjordan opened 2 months ago

pmjordan commented 2 months ago

CSD06 section 4 contains the text: "However, a complete architecture must ... clearly distinguish between the four kinds of TOSCA entities defined in Section 2.4." But section 2.4 now deals with CSAR files and it is not clear (to me) where these four kinds are introduced. Furthermore 'TOSCA entities' in the rest of the document means TOSCA syntax elements such as node, interface, relationship etc.

koppor commented 2 months ago

The section did not exist in TOSCA 1.3.

Section 3.8 in CSD05 defined these entities: https://docs.oasis-open.org/tosca/TOSCA/v2.0/csd05/TOSCA-v2.0-csd05.html#_Toc125468387

I think, the word "Entity" is not the right term here, because it is used differently in other sections. E.g. 9.4:

TOSCA entity (e.g., node template, relationship template, etc.)

pmjordan commented 2 months ago

Thank you for the reference to CSD05. I agree we should not use the term entity here. Perhaps we can say 'However, a complete architecture must ... clearly distinguish between the different types of TOSCA abstractions introduced in the section TOSCA language abstractions.