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

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

Thanks,  Paul.  The TC will review.

Best regards,

Paul

From mobile

---

From: tosca-comment@lists.oasis-open.org <tosca-comment@lists.oasis-open.org> on behalf of Paul Knight <paul.knight@oasis-open.org>
Sent: Wednesday, May 22, 2019 5:04:29 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