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#_Toc433298764Thanks, and best regards,
Paul
--
Paul Knight <
paul.knight@oasis-open.org> - Tel: +1 781-883-1783
OASIS <https://www.oasis-open.org/> - Advancing open standards for the
information society - Document Process Analyst
<https://www.oasis-open.org/people/staff/paul-knight>
Identity Ecosystem Steering Group <https://www.idecosystem.org/> -
Framework Management Office