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


Help: OASIS Mailing Lists Help | MarkMail Help

obix message

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

Subject: [OASIS Issue Tracker] Created: (OBIX-94) Narrative style not appropriate for a standard

Narrative style not appropriate for a standard

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

"The style of the narrative reads more like a user guide than a standard. 

- In many places, the author uses ""we"". That should be generally avoided. E.g.: ""..., we typically don't allow defaults to be used"" --> replace with ""...default values are generally not allowed"". 

- ""There isn't much more to say about implicit Contracts other than it is recommended that a human brain be involved. "" Such an expression is hard to parse as of its exact meaning (even more so for a non-native speaker...): to avoid. 

- Casual style belongs more to a primer or user guide: ""So now let's look at the rules governing the explicit Contract."""

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]