This wiki is locked. Future workgroup activity and specification development must take place at
our new wiki
. For more information, see
this blog post about the new governance model
and
this post about changes to the website
.
TWiki
>
Main Web
>
OslcCore
>
OslcCoreV2Issues
(23 Aug 2012,
LeeReamsnyder
)
(raw view)
---+!! OSLC Core Spec V2 Issues ---++++++ This page has moved to the [[/wiki/core/][new wiki for the Core workgroup]]. Find the [[http://open-services.net/wiki/core/OSLC-Core-V2-Issues/][latest version there including OPEN and RESOLVED issues and Changes that have happened after FINALIZATION]] This document captures the issues raised against the OSLC Core Spec v2. * OslcCoreSpecification - the OSLC Core Specification To see the list of issues that occurred during the convergence phase see OslcCoreV2ConvergenceIssues ---+ Finalization issues *CLOSED and DEFER issues are here. OPEN and RESOLVED issues moved to [[http://open-services.net/wiki/core/OSLC-Core-V2-Issues/][the new wiki]].* This section tracks finalization issues, some of which have been or will be reflected in changes above. These are the issues raised during the development of the OSLC Core spec up to finalization time. Note: dates below use US format (mm/dd/yyyy) Here's what the states mean: * %RED%OPEN%ENDCOLOR% - indicates that we have no response for the issue yet * %GREEN%RESOLVED%ENDCOLOR% - indicates that we have a response that we believe resolves the issue * CLOSED - issue has been resolved and the resolution has been reviewed by the WG * %ORANGE%DEFERRED%ENDCOLOR% - indicates that issue will be addressed in Core Guidance v1.0 during the month after the Core Specification is final. * %PURPLE%TABLED%ENDCOLOR% - indicates that issue will be reconsidered at some later but unspecified date Issues: 1 CLOSED We should reconsider requiring clients to ask for paging * No, things work well as is 1 CLOSED On requests for too large resources, OSLC Services should be able to redirect to URL that specifies paging * Yes and we should specify how this should be done. Proposed new spec text discussion here: * [[http://open-services.net/pipermail/oslc-core_open-services.net/2010-December/000651.html]] 1 CLOSED We need to make it clear that the oslc:ResponseInfo properties' subject resource is the page URL and not the base resource URL * This is already clear because paging is always indicated in the URL 1 CLOSED What does oslc:totalSize mean, is it total number of triples or what? * Yes, we need to clarify this. Proposed new spec text discussion here: * Thread is here: [[http://open-services.net/pipermail/oslc-core_open-services.net/2010-December/000649.html]] * Response: clarification has been made - DaveJohnson 1 %PURPLE%DEFER%ENDCOLOR% oslc:ResponseInfo should be renamed to oslc:Page * Consensus: Too late for such a change 1 %PURPLE%DEFER%ENDCOLOR% oslc:paging should be renamed to oslc:pagination * Consensus: Too late for such a change 1 %PURPLE%DEFER%ENDCOLOR% use rdf:next instead of oslc:nextPage * Consensus: Too late for such a change 1 CLOSED In section Graph Patterns. re: "defines a starting subject resource, namely the base URI itself" - First paragraph: Which base URI, specified how? I think you mean the “starting subject resource” but cannot be sure. “Base URI” is particularly troublesome since a given URI can have many potential base URIs. (JA, Dec. 9, 2010) * Added clarification, pointing to Service Provider - Creation Factory (Dave Johnson, Dec 9, 2010) 1 CLOSED Definition of =oslc:totalCount= is not clear. * Resolution is to say something like this: if resource is from a Query Syntax URL, then this is number of RDF nodes, if not then it is a relative measure of the size of the resulting resource across all pages. * Resolution: Changes have been applied (DaveJohnson, Dec. 17, 2010) 1 CLOSED In section "Property tree patterns" - I'd be careful with how this is stated. I think you want to allow implementations to support wider query scopes. If a client understands some RTC-specific property, I think you want to allow it just not require it. Unclear if this is intended to be a MUST NOT, informative, or what. (JA, Dec. 9, 2010) * Resolution: we want to allow wider scope but not require it, so now we say "MAY be limited" (DaveJohnson, Dec. 17, 2010) 1 CLOSED re: "scope of the query is limited to the boundaries of the service". Need definition for "nested properties" Should I read this to imply that the “initial resource”, which may or may not be the same as the “starting subject resource”, must not have any nested properties (whatever those are)? (JA, Dec. 9, 2010) * Resolution: added definition for Nested Property (DaveJohnson, Dec. 17, 2010) 1 CLOSED In section "Prefixed Names" - Don’t recall [Prefixed Names] being defined anywhere in Core. Obvious enough for XML weenies, but probably not for json weenies. What is hear frankly comes across as a circular definition. (JA, Dec. 9, 2010) * Resolution: added definition for Prefixed Name and referred to SPARQL spec for precision (DaveJohnson, Dec. 17, 2010) 1 %PURPLE%DEFERRED%ENDCOLOR% Query parameters, re: "syntax is formally defined using a common extended form of BNF" (JA, Dec. 9, 2010) * Resolution: added reference to wikipedia definition of EBNF. We do need a better grammar and prefer to use ANTLR since it is machine readable and supported by tools, but we will defer until a later version of the Core spec (DaveJohnson, Dec. 17, 2010) 1 CLOSED Syntax for 'space' - I notice your grammar precludes >1 consecutive space. That seems rather unforgiving. Would be tempted to make it 0:* and then in the text here state that implementations MUST support the single space and MAY support >1, if there is really a good reason to distinguish. (JA, Dec. 9, 2010) * Resolution: we are OK with being unforgiving here. The syntax is intended for use in URLs and not written directly by end-users and we'd like to make things easier for those implementing parsers (DaveJohnson, Dec. 17, 2010) 1 CLOSED Syntax for 'comparison_op' - I don’t think the comparison ops are close to fully specified. I have no idea what it means to compare a Boolean to a string in your language, but I don’t think you prevented that. Let alone boolean1 > boolean2 and similar. String comparisons have all sorts of collating sequence issues that need to be handled if you really want interoperability. (JA, Dec. 9, 2010) * Resolution: added note that datatypes and operator semantics MUST work as defined in SPARQL query language (DaveJohnson, Dec. 17, 2010) 1 CLOSED Syntax for 'in_op' - Nitty I know, but according to the BNF the spaces are not part of the operator. So either you imply that the values being tested cannot contain a comma, or there is some escaping mechanism left unspoken here. (JA, Dec. 9, 2010) * Resolution: No change because there is no chance of ambiguity about commas, things without quotes true, false, numbers. Only strings are contained in quotes. (DaveJohnson, Dec. 17, 2010) 1 CLOSED Syntax for 'literal_value' - re: "datatype URI" - If there is a formal OSLC-defined name for this, encourage you to use it here. As an XML schema weenie, this construction leads me to xs:anyURI at first glance. (JA, Dec. 9, 2010) * Resolution: No change because we already refer to the Refer to SPARQL spec for syntax of URIs (DaveJohnson, Dec. 17, 2010) 1 CLOSED Section 'oslc.searchTerms' re: "Each resource that is returned in the response is annotated with a special property, oslc:score, that gives its match score." Do you mean to say MUST be? (JA, Dec. 9, 2010) * Resolution: Yes, this is now a MUST (DaveJohnson, Dec. 17, 2010) 1 CLOSED Section 'oslc.searchTerms' Integer? Not actually sure why you bother to constrain this at all, but given that you feel the need and given that your example appears to use only integers, worth asking. * Resolution: No change. Number is correct because we want to allow floats here (DaveJohnson, Dec. 17, 2010) 1 CLOSED Section 'oslc.orderBy' - definition needed for Nested Properties (JA, Dec. 9, 2010) * Resolution: Fixed by #11 above (DaveJohnson, Dec. 17, 2010) 1 CLOSED Section 'oslc.select' - "then the matching process does NOT match" - This could easily be read to mean that no members would match (you’d always get 0 members back), which is clearly not the intent. Don’t you just want something like “…then this (absent) criterion does not affect the list of members returned.”? It’s quite hard to clearly define a negative. * Resolution: accepted suggested clarification (DaveJohnson, Dec. 17, 2010) 1 CLOSED =oslc:discussion= is listed as a common property (in CmSpecificationV2 ) but it is not listed as such in OSLCCoreSpecAppendixA Also suggested is a better name like =oslc:discussedBy= (WikiName, 01/07/2011) * *Response* Adding to Appendix A and renaming to oslc:discussedBy. (SteveSpeicher 1/21/2011) 1 CLOSED =oslc:discussion= is also listed as a property of =oslc:Comment= in OSLCCoreSpecAppendixA though with a different meaning (WikiName, 01/07/2011) * *Response* From =oslc:Comment= renamed =oslc:discussion= to =oslc:partOfDiscussion=. (SteveSpeicher 1/21/2011) 1 %PURPLE%DEFER%ENDCOLOR% How to create =oslc:Comment= resources? Appears to be no guidance, perhaps a Core issue? (WikiName, 01/07/2011) * *Response* Possible ways to handle: add informative section saying to use creation factories or simply use resource update, adding a new comment entry. There once was a statement about POSTing to the Discussion URL to create comments, not sure why it was removed.. (SteveSpeicher mm/dd/2011) 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-August/001017.html][Encoding of UI preview label]] (SamPadgett, 08/15/2011) * *Response* From OslcCoreMeeting20111019 [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-October/001118.html][agreed on changing from XMLLiteral to string]](SteveSpeicher 10/19/2011) * Suggested [[http://open-services.net/pipermail/oslc-core_open-services.net/2012-June/001356.html][spec changes]] (SteveSpeicher 6/20/2012) * Awaiting final feedback from implementers * FIXED made suggestion change in [[OslcCoreUiPreview?rev=27][rev 27]], still need to propose some footnote text 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-August/001022.html][JSON formatting rules ambiguities]] (JohnArwe, 08/15/2011) * *Response* [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-September/001091.html][Response sent via email]] (MichaelFiedler 9/21/2011) * FIXED in http://open-services.net/bin/view/Main/OSLCCoreSpecAppendixRepresentations?rev=18 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-September/001076.html][dialog prefilling awkward statement]] (JohnArwe, 09/01/2011) * *Response* Clarification on wording suggested [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-September/001082.html][in email]] and made changed in [[http://open-services.net/bin/view/Main/OslcCoreSpecification?rev=68][revision (SteveSpeicher 9/21/2011) 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-September/001075.html][mail thread]] [[http://open-services.net/bin/view/Main/OslcCoreSpecification#Resource_Selection][resource selection section]] the first table under that heading contains the string "occurs" in each row of its "Occurs" column instead of zero-or-one etc (JohnArwe, 09/01/2011) * *Response* Simple fix the entries in the table (SteveSpeicher 9/21/2011) * FIXED in http://open-services.net/bin/view/Main/OslcCoreSpecification?rev=61 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-September/001077.html][mail thread]] oslc:shortTitle differences (JacobYackenovich, 09/01/2011) * *Response* Fix problem with saying it should be <span> instead of <div>. Indicate that UI Preview is an XML element while the common properties is an RDF property (SteveSpeicher 9/21/2011) * FIXED in http://open-services.net/bin/view/Main/OSLCCoreSpecAppendixA?rev=25 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-November/001174.html][How to expose a non-OSLC domain using oslc:domain]] (JohnArwe 10/21/2011) * *Response* John [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-November/001174.html][proposed updated spec]] based on WG discussion (JohnArwe 11/23/2011), discussed at Nov 30 meeting, no objections after meeting and one [[http://open-services.net/pipermail/oslc-core_open-services.net/2011-December/001186.html][+1 response]] * FIXED in [[http://open-services.net/bin/view/Main/OslcCoreSpecification?rev=66][revision 66 - SP Catalog]] and [[http://open-services.net/bin/view/Main/OslcCoreSpecification?rev=67][revision 67 - SP]] and [[http://open-services.net/bin/view/Main/OslcCoreVocabulary?rev=10][vocabulary revision 10]] (JohnArwe 06/20/2012, 06/21/2012 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2012-February/001231.html][Icon alt/title text]] (Bill Andreas 2/15/2012) * *Response* Consider adding a couple of properties for this, [[http://open-services.net/pipermail/oslc-core_open-services.net/2012-July/001422.html][proposal sent to WG]] almost have consensus (SteveSpeicher) * FIXED: Updated [[OslcCoreUiPreview?rev=28][UIPreview r28]] (SteveSpeicher 8/3/2012) 1 CLOSED [[http://open-services.net/pipermail/oslc-core_open-services.net/2012-March/001239.html][oslc.properties questions]] - (IanGreen 3/14/2012) * *Response* Handled [[http://open-services.net/pipermail/oslc-core_open-services.net/2012-March/001252.html][via email to clarify]] - SteveSpeicher 3/31/2012
E
dit
|
A
ttach
|
P
rint version
|
H
istory
: r194
<
r193
<
r192
<
r191
<
r190
|
B
acklinks
|
V
iew topic
|
Ra
w
edit
|
M
ore topic actions
Topic revision: r194 - 23 Aug 2012 - 22:15:05 -
LeeReamsnyder
Main.OslcCoreV2Issues moved from Main.OslcCoreV1Issues on 23 Aug 2011 - 13:36 by
SteveSpeicher
-
put it back
Main
Main Web
Create New Topic
Index
Search
Changes
Notifications
RSS Feed
Statistics
Preferences
Webs
Main
Sandbox
TWiki
Български
Cesky
Dansk
Deutsch
English
Español
Français
Italiano
日本語
Nederlands
Polski
Português
Русский
Svenska
简体中文
簡體中文
Copyright � by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use
Ideas, requests, problems regarding this site?
Send feedback