OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

coel message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: [OASIS Issue Tracker] (COEL-114) COEL - Normative - Misuse of MUST 3.2.2 Artefact Style Guide


    [ https://issues.oasis-open.org/browse/COEL-114?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=67112#comment-67112 ] 

Paul Bruton commented on COEL-114:
----------------------------------

We have taken this on board along with other comments and decided to use the approach in the TOSCA YAML standard (https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=tosca)

> COEL - Normative - Misuse of MUST 3.2.2 Artefact Style Guide
> ------------------------------------------------------------
>
>                 Key: COEL-114
>                 URL: https://issues.oasis-open.org/browse/COEL-114
>             Project: OASIS Classification of Everyday Living (COEL) TC
>          Issue Type: Bug
>         Environment: Normative
>            Reporter: Chet Ensign
>              Labels: TAB_CD02_OBSERVATION, conformance
>
> 3.2.2 Artefact Style Guide reads: 
> *****
> The string descriptions MUST be formatted with only the first word capitalised with no punctuation, abbreviations or trailing spaces. The Clusters MUST be single words with no spaces.
> *****
> The control word "MUST" is not needed here. The normative text of a standard states the rules for constructing names/values, etc. MUST is only required in conformance clauses. 
> BTW, don't use the definite article "the" when you want to refer to any possible string description or cluster. 
> See the proposal for a re-write.



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]