RE: [tosca-comment] feedback on TOSCA-Simple-Profile-YAML-v1.1-csd01-final (comments removed).docx

["Lipton, Paul C" <Paul.Lipton@ca.com>]

Hi Mike,

I acknowledge and thank you for your comments. I will distribute for future consideration. 

Regards,
Paul Lipton 
TOSCA TC Co-Chair


-----Original Message-----
From: tosca-comment@lists.oasis-open.org [mailto:tosca-comment@lists.oasis-open.org] On Behalf Of Mike Gerdts
Sent: Tuesday, August 30, 2016 2:39 PM
To: tosca-comment@lists.oasis-open.org
Subject: [tosca-comment] feedback on TOSCA-Simple-Profile-YAML-v1.1-csd01-final (comments removed).docx

Hi All,

I've been spending some time trying to get my head around TOSCA and have noticed a few things that seem to be minor problems/nits. These comments relate to:

https://urldefense.proofpoint.com/v2/url?u=https-3A__www.oasis-2Dopen.org_apps_org_workgroup_tosca_download.php_58781_TOSCA-2DSimple-2DProfile-2DYAML-2Dv1.1-2Dcsd01-2Dfinal-2520-2528comments-2520removed-2529.docx&d=DQICaQ&c=_hRq4mqlUmqpqlyQ5hkoDXIVh6I6pxfkkNxQuL0p-Z0&r=3UUaotXGpqHidtIBP1k_gYHXTeBFOTS36FpSS_-nzAk&m=0g0Zk9cfIcxgNBvbnia-F9egrL0g-N8NYvVLxx4uBdU&s=O9y6f9gUU8m2az9LdWDtcs0N2NQ5eLe-MUL194K3i6g&e= 

Line 3: Specification misspelled

Section 11.1.15.3: the wordpress node_template calls "get_input: 
context_root".  context_root is not a defined input.

Section 11.1.7.3: Parts of the yaml use the Normal style where they should use Code Snippit.  This happens in the description and "topology_template:".

I'm not sure how standard the yellow highlight in the "code snippit" 
areas is across OASIS documents.  A long while back I did the same thing and found that when printed on a black and white printer that the yellow highlight was not distinguishable from the gray background.  I solved this by adding a style that did the yellow shading (nice for pdf
viewing) and a wavy underline (distinguishable in b&w print).  I don't feel strongly that the document should be changed in this way, just sharing experience in case this improves the usability for tree killers.


That's all for now.

Mike

--
This publicly archived list offers a means to provide input to the OASIS Topology and Orchestration Specification for Cloud Applications (TOSCA) TC.

In order to verify user consent to the Feedback License terms and to minimize spam in the list archive, subscription is required before posting.

Subscribe: tosca-comment-subscribe@lists.oasis-open.org
Unsubscribe: tosca-comment-unsubscribe@lists.oasis-open.org
List help: tosca-comment-help@lists.oasis-open.org
List archive: https://urldefense.proofpoint.com/v2/url?u=http-3A__lists.oasis-2Dopen.org_archives_tosca-2Dcomment_&d=DQICaQ&c=_hRq4mqlUmqpqlyQ5hkoDXIVh6I6pxfkkNxQuL0p-Z0&r=3UUaotXGpqHidtIBP1k_gYHXTeBFOTS36FpSS_-nzAk&m=0g0Zk9cfIcxgNBvbnia-F9egrL0g-N8NYvVLxx4uBdU&s=VxAmeo8xke93J9j-XI7NEKdgPeToCj73A8zqXSe4c7o&e=
Feedback License: https://urldefense.proofpoint.com/v2/url?u=http-3A__www.oasis-2Dopen.org_who_ipr_feedback-5Flicense.pdf&d=DQICaQ&c=_hRq4mqlUmqpqlyQ5hkoDXIVh6I6pxfkkNxQuL0p-Z0&r=3UUaotXGpqHidtIBP1k_gYHXTeBFOTS36FpSS_-nzAk&m=0g0Zk9cfIcxgNBvbnia-F9egrL0g-N8NYvVLxx4uBdU&s=pgfJpMSNKP9KAYLYjcuGwsWsICijzUuqk2fSEvSrQ-4&e=
List Guidelines: https://urldefense.proofpoint.com/v2/url?u=http-3A__www.oasis-2Dopen.org_maillists_guidelines.php&d=DQICaQ&c=_hRq4mqlUmqpqlyQ5hkoDXIVh6I6pxfkkNxQuL0p-Z0&r=3UUaotXGpqHidtIBP1k_gYHXTeBFOTS36FpSS_-nzAk&m=0g0Zk9cfIcxgNBvbnia-F9egrL0g-N8NYvVLxx4uBdU&s=vp10L7I9ItZVJd6UmqqiAOa_dk8EFK5su41ZotP_skE&e=
Committee: https://urldefense.proofpoint.com/v2/url?u=http-3A__www.oasis-2Dopen.org_committees_tosca&d=DQICaQ&c=_hRq4mqlUmqpqlyQ5hkoDXIVh6I6pxfkkNxQuL0p-Z0&r=3UUaotXGpqHidtIBP1k_gYHXTeBFOTS36FpSS_-nzAk&m=0g0Zk9cfIcxgNBvbnia-F9egrL0g-N8NYvVLxx4uBdU&s=k7Xtux7ztajwAVXP3tgIeRdRNnQdv_kM7jmdcuRgDRI&e=
Join OASIS: https://urldefense.proofpoint.com/v2/url?u=http-3A__www.oasis-2Dopen.org_join_&d=DQICaQ&c=_hRq4mqlUmqpqlyQ5hkoDXIVh6I6pxfkkNxQuL0p-Z0&r=3UUaotXGpqHidtIBP1k_gYHXTeBFOTS36FpSS_-nzAk&m=0g0Zk9cfIcxgNBvbnia-F9egrL0g-N8NYvVLxx4uBdU&s=a5KbZeivwuc29ADh8r40L07Mj4hvINbTQUSGjajCGYs&e=