Re: [tosca-comment] Public Review comments for TOSCA Simple Profile in YAML v1.3

Thanks,  Paul.  The TC will review. 

Best regards, 

Paul

From mobile

From:  <> on behalf of Paul Knight <>

Sent: Wednesday, May 22, 2019 5:04:29 PM

To: 

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/

(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