[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]