RE: [tosca] TC Admin comments on TOSCA Simple Profile in YAML v1.1 CS01

Hi Chet,

Thanks for catching these items. With input from the editors, the TC will decide how to address these issues with the appropriate non-material changes.

Regards,

Paul

From: tosca@lists.oasis-open.org [mailto:tosca@lists.oasis-open.org] On Behalf Of Chet Ensign
Sent: Tuesday, August 8, 2017 11:34 AM
To: tosca@lists.oasis-open.org
Cc: Paul Knight <paul.knight@oasis-open.org>
Subject: [tosca] TC Admin comments on TOSCA Simple Profile in YAML v1.1 CS01

Members of the TOSCA TC,

Congratulations on the publication of TOSCA Simple Profile in YAML v1.1 Committee Specification 01!

In preparing the CS for publication, we noted some problems that you may wish to fix in future rounds of publication. These were items we could not fix because they involved your content, which we generally do not touch unless a problem occurs because of our processing.

We run 2 link checkers: "pinger" in FireFox and the W3C link checker (http://validator.w3.org/checklink). In this case, the W3C check detected several significant items. You can get the report yourself by going to https://validator.w3.org and entering the URL for the HTML version of the spec.

It looks like some links point to the editors' local file systems.

Several of the names listed in the Acknowledgments section have bad links appended to the hyperlink for their email address, including:

Frank Leymann

Kapil Thangavelu

Nikunj Nemani

Richard Probst

There are a number of broken links noted: (line numbers are from the HTML file)

Lines: 1367, 1488, 10721, 24719, 24736, 34195, 38914, 38919, 38974, 39003, 39006, 39009, 39028, 39031

Some of the links to this resource point to broken URI fragments (such as index.html#fragment).

Broken fragments:

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#DEFN_ELEMENT_CONSTRAINTS (line 10721)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_MYSQL_DBMS_START_SH (line 39006)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_WEBSERVER_INSTALL_SH (line 39028)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#TYPE_TOSCA_PROP_PORTDEF (lines 24719, 24736)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_MYSQL_DBMS_INSTALL_SH (line 39003)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_WEBSERVER_START_SH (line 39031)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_MYSQL_DATABASE_CONFIGURE_SH (line 38974)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_WORDPRESS_INSTALL_SH (line 38914)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_WORDPRESS_CONFIGURE_SH (line 38919)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#UC_2_MYSQL_DBMS_CONFIGURE_SH (line 39009)

http://docs.oasis-open.org/tosca/TOSCA-Simple-Profile-YAML/v1.1/cs01/TOSCA-Simple-Profile-YAML-v1.1-cs01.html#DEFN_TYPE_RELATIONSHIPS_NETWORK_CONNECTS (line 34195)

In other cases, internal cross references have become entangled in the TC Editor's local system, for instance:

- the reference to Chapter 2.1 at the next to the last paragraph in 2.9.2

- the first two links to "string" in the table in 4.8.1.2

Please let us know if you have any questions on these issues.

Best,

/chet
----------------
Chet Ensign
Director of Standards Development and TC Administration
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393

tosca message