[OASIS Issue Tracker] Commented: (CAMP-84) Text highlighting, Section 2.1.6 and following (camp-spec-v1.1-csprd01)

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ http://tools.oasis-open.org/issues/browse/CAMP-84?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=34479#action_34479 ] 

Adrian Otto commented on CAMP-84:
---------------------------------

We intend to add explanatory text to the spec that addresses what is normative text, what the table of normative statements is for, and why there is a color coding scheme.

> Text highlighting, Section 2.1.6 and following (camp-spec-v1.1-csprd01)
> -----------------------------------------------------------------------
>
>                 Key: CAMP-84
>                 URL: http://tools.oasis-open.org/issues/browse/CAMP-84
>             Project: OASIS Cloud Application Management for Platforms (CAMP) TC
>          Issue Type: Bug
>          Components: Public Review
>         Environment: csprd01
>            Reporter: Martin Chapman 
>
> From Patrick Durusau <patrick@durusau.net>
> Copied from the comment list: https://lists.oasis-open.org/archives/camp-comment/201308/msg00002.html 
> Greetings!
> Starting at Section 2.1.6, the last paragraph has this text:
> ***
> An Application Component Template SHALL be referenced by a single
> Assembly Template. [CO-01] An Assembly Template SHALL NOT be
> instantiated until all of its Application Component Templates are
> successfully instantiated.
> ***
> highlighted in pink/orange? Sorry, I'm not very good with colors, but
> distinct from the surrounding text in any event.
> After looking at a number of instances of this highlighting, it
> appears to be used when RFC 2119 keywords appear in the text.
> I did not find (overlooked?) any mention of why these passages were
> highlighted in the spec.
> Is this an artifact of the editing process and meant to be removed?
> If not, some explanation of why the text is highlighted would be
> helpful. Although, text that does not use RFC 2119 keywords is just as
> normative as text that does (the latter voicing requirements) so I'm
> not sure it is useful to the general reader.
> BTW, to resolve this after public review should be a non-substantive
> change since none of the text would change, just its coloring.
> Hope everyone is having a great day!
> Patrick
> PS: The highlighting occurs in the PDF, Word, and, HTML versions of
> camp-spec-v1.1-csprd01.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira