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

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

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