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:  [mailto:]
On Behalf Of Chet Ensign

Sent: Tuesday, August 8, 2017 11:34 AM

To: 

Cc: Paul Knight <>

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