Public Review comments for TOSCA Simple Profile in YAML v1.3

[Paul Lipton <paul.lipton@LIVE.COM>]

Hi TOSCA-teers,

 

Please find the below issues from OASIS Staff for the first review. I will enter these comments in our Comment Resolution Log for TC review after the review period is concluded.

 

Regards,

Paul

From: tosca-comment@lists.oasis-open.org <tosca-comment@lists.oasis-open.org> On Behalf Of Paul Knight
Sent: Wednesday, May 22, 2019 5:04 PM
To: tosca-comment@lists.oasis-open.org
Subject: [tosca-comment] Public Review comments for TOSCA Simple Profile in YAML v1.3

 

Hi TOSCA TC members,

 

During preparation of the files for publication, I noted the following issues:

 

  link checker found 13 invalid links in text:

  in 1.8 (Non-Normative References), the link to [Chef] is invalid (no response from site)

  In 2.9.2, a link for "Chapter 2.1" is linked to file:///C:/Users/Chris/Downloads/hello_world#_A_

  in 3.6.7.3, an example link has a live hyperlink instead of being plain text

  in 4.8.1.2, the first two links for "string" in the Type column are linked to file:///C:/Users/IBM_AD~1/AppData/Local/Temp/TOSCA_get_artifact_proposal-1.docx#TYPE_YAML_STRING

  in 4.8.1.3.1, two examples have live hyperlinks instead of being plain text

  in 4.8.1.3.2, the example "/tmp/wordpress.zip" is linked to file://///home/user/wordpress.zip

  in Appendix B (Acknowledgments) , there are five email addresses which have been corrupted to point to links like file:///C:/Users/IBM_ADMIN/Documents/IBM/SWG/Standards/SDOs/OASIS/TOSCA/Interop%20SC/YAML/kraman@redhat.com
(Frank Leymann, Kapil Thangavelu, Krishna Raman, Nikunj Nemani, Richard Probst)

â other issues:
â In section 8.4.3, the image is duplicated. This has been present in the drafts for this specification for years. (For example, see 8.4.3 in https://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/csprd02/TOSCA-Simple-Profile-YAML-v1.1-csprd02.html, from January 2017. PLEASE fix it.
â in 11.1.19.2, there is a hyperlink to "http://1.1.1.1/images/ubuntu-14.04.qcow2" which links to a site advertising "Cloudflare" instead of being plain text

 

Best regards,

Paul Knight

--

Paul Knight....Document Process Analyst...mobile: +1 781-883-1783

OASIS - Advancing open standards for the information society