OASIS Topology and Orchestration Specification for Cloud Applications (TOSCA) TC

Back to discussions
Expand all | Collapse all

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

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

    Posted 05-23-2019 02:31




    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




















Related Content