RE: [tosca-comment] TOSCA Simple Profile for NFV v1.0 - csd02

Hi Paul,

Thank you for your feedback. I will ensure that these are reviewed by our NFV team.

Thanks,

Paul

From: tosca-comment@lists.oasis-open.org [mailto:tosca-comment@lists.oasis-open.org] On Behalf Of Paul Knight
Sent: Friday, October 23, 2015 2:28 PM
To: tosca-comment@lists.oasis-open.org
Subject: [tosca-comment] TOSCA Simple Profile for NFV v1.0 - csd02 - comments during publication

Hi TOSCA NFV team,

During publication of the csd02, I noted a few items which should be corrected or considered for future versions:

- namespace - In Section 6.1 [1], the namespace is declared as:

http://docs.oasis-open.org/tosca/ns/simple/yaml/1.0/nfv/1.0/

There is nothing specifically wrong with this construction, but I want to bring it to your attention for careful consideration.. I had a couple of specific questions - Is this intended as a sub-namespace of the "TOSCA Simple Profile in YAML v1.0" namespace ( http://docs.oasis-open.org/tosca/ns/simple/yaml/1.0)? Is there a reason for the terminal "/"?

I would have anticipated a construction more parallel with the TOSCA-yaml namespace (above) or the base TOSCA namespace (http://docs.oasis-open.org/tosca/ns/2011/12), perhaps something like "http://docs.oasis-open.org/tosca/ns/simple/nfv/1.0"

However, namespace names are arbitrary, and the TC can choose any acceptable string structure after the base "http://docs.oasis-open.org/tosca/ns/"

- nit - also in 6.1, it appears that the references to "version 1.0.0" in the text was mistakenly left as-is, while others were changed from 1.0.0 to 1.0 (see Revision History[2] entry for 2015-7-2).

- Formatting of some list items, so they don't show up in the Table of Contents.

I noted two places where a total of five list items had a paragraph type which caused them to appear in the Table of Contents.

The items are:

- The three numbered paragraphs under Section 5.

- In the Acknowledgments section (Appendix A), the line "Participants" and the line for Chris Lauwers.

The fix required here for each case is to modify the paragraph style so that the "Outline level" is "Body Text" instead of "Level 1".

Specific gesture in MS-Word:

Place cursor in the line, right click, choose "Paragraph". Choose the "Indents and Spacing" tab. Make the change in "Outline level".

Now these items will not show up in the Table of Contents.

[1] Section 6.1: http://docs.oasis-open.org/tosca/tosca-nfv/v1.0/csd02/tosca-nfv-v1.0-csd02.html#_Toc433298708

[2] Revision History: http://docs.oasis-open.org/tosca/tosca-nfv/v1.0/csd02/tosca-nfv-v1.0-csd02.html#_Toc433298764

Thanks, and best regards,

Paul

Paul Knight - Tel: +1 781-883-1783
OASIS - Advancing open standards for the information society - Document Process Analyst
Identity Ecosystem Steering Group - Framework Management Office

tosca-comment message