search

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
4 stars 5 forks source link

"single-line relationship grammar" is multi line #75

Open koppor opened 1 month ago

koppor commented 1 month ago

It is promised that there is a single-line grammar for a "symbolic name of a relationship template to use". However, the grammar is the same as above

image

https://docs.oasis-open.org/tosca/TOSCA/v2.0/csd06/TOSCA-v2.0-csd06.html#872-requirement-assignment-grammar

lauwers commented 1 month ago

The examples are correct, but the text describing the examples is confusing. The example you're referencing uses a <relationship_template_name>. The example right above it uses a <relationship_type_name>. We'll try to make the descriptions less confusing.

lauwers commented 1 month ago

Clarifications have been merged into the OASIS repository

koppor commented 1 month ago

I would have assumed that I can just list a single relationship template (instead of listing capabilities and other things). Thus, it would really be a single line grammar.

lauwers commented 1 month ago

Could you provide an example of the single line grammar you have in mind?

koppor commented 1 week ago

I think, it is as simple as

<requirement_name>:
  relationship: <relationship_template_name>

(I haven't fully thought through - however, this snippet would match the paragraph "As stated in the description of the supported keynames [...]")

koppor commented 1 week ago

Side story: Maybe, I am struggling with the term single-line grammar

Other places in the spec show a single line. - Meaning count(lines) == 1.

image

image

image

(and more)

Here it is "OK", the reader should understand that 1 and 2 are to be read as "single-line"

image