[OASIS Issue Tracker] Created: (OBIX-164) 1.6 Editing Conventions - examples

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

1.6 Editing Conventions - examples
----------------------------------

                 Key: OBIX-164
                 URL: http://tools.oasis-open.org/issues/browse/OBIX-164
             Project: OASIS Open Building Information Exchange (oBIX) TC
          Issue Type: Bug
          Components: OBIX 1.1 Specification
    Affects Versions: OBIX 1.1 XSD PR02
         Environment: TAB Review
            Reporter: Toby Considine
            Assignee: Toby Considine


"1.6 Editing Conventions currently reads in part: 

***** 
All sections explicitly noted as examples are informational and SHALL NOT be considered normative. 
***** 

But at 4.2.1.1 bool, I find: 

***** 
An example: 

<bool val=""true""/> 
***** 

Clearly an example but not excluded from normative text by 1.6. 

Consider whether examples should be typographically distinct with language in 1.6 saying that all examples are non-normative. 

I count 19 uses of the phrase ""an example"" where an actual example follows. (Excluding use of ""an example"" in prose.)"

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