[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [OASIS Issue Tracker] Commented: (CAMP-84) Text highlighting, Section 2.1.6 and following (camp-spec-v1.1-csprd01)
[ 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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]