[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: [OASIS Issue Tracker] Created: (OBIX-116) OBIX implementation(s) not well defined
OBIX implementation(s) not well defined
---------------------------------------
Key: OBIX-116
URL: http://tools.oasis-open.org/issues/browse/OBIX-116
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
"
Reading the beginning of the Conformance Clause: it talks of ""implementation"" as its very first word.
But the only formal definition of ""implementation"" is in Contracts (""An Object which implements a Contract is said to be an implementation of that Contract."") so it naturally seems this is the ""implementation"" the conformance clause is talking about, in its introductory part. But my hunch is it is not...
- we see ""server implementation"" at a few places. So then [OBIX] server would need to be defined, in turn.
- we also see ""OBIX implementation"". Is it different from server implementation?
- we also see OBIX server (and OBIX Client) here and there. But again no clear definition.
- further in the conformance clause, we finally see: ""An implementation is a conforming OBIX Server if it meets the conditions described in Section 17.1. "". But again, that sounds circular: ""OBIX Server "" is already used before in the body of the specification, it should have a definition that does not rely on the conformance clause.
Advice:
- define [OBIX] Server and Client early on in the spec, based on their general function and role. Then stick to this terminology throughout.. The conformance clause can then establish their precise conformance conditions (without attempting to define these terms).
- the whole text just at beginning of conformance section (and before 17.1 seems redundant, it is sufficient to recall what are the different types of implementations that will be dealt with (and that should be defined previously as they are used previously ).
"
--
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]