[OASIS Issue Tracker] Created: (OBIX-34) Section 3 - Simple editorial comments

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

Section 3 - Simple editorial comments
-------------------------------------

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


155: replace with The oBIX design philosophy recognizes a commonality of functionality of the components of all control systems while hiding the underlying mechanisms and protocols. To that end, OBIX relies on the principles in Table [n].
 
156-161. Replace bullet points with a named table.
 
Should REST be replaced with CRUD? We can then add a sentence that suggests "For this document, we use REST operations as examples of CRUD operations in oBIX."
 
158: A better definition of URI, including translation of acronym. Reference to RFC 3986 would be good.
 
164: Remove "cleverly"
 
208-209L "Since OBIX is used to interact with control systems over the web, we use the URL to identify each resource. Just as we assume an XML encoding and a REST binding for all examples in this document, so to we assume a URL using the hypertext transfer protocol (URLs beginning with http:) beginning with HTTP. This is not meant to forbid the use of secure transfer (https:) or of other protocols (ws:). Neither are the examples are meant to forbid the use of alternate ports. The URLs in examples in this document are for illustration only.
Or, see detailed comment on URLs. Below.
 
240-242: Consider replacing first 3 sentences with:
In oBIX, these patterns are modeled as a template object named the Contract.
 
244: Remove words "In Geek Speak". Replace with "Formally" if desired.

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