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

 


Help: OASIS Mailing Lists Help | MarkMail Help

odata message

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


Subject: [OASIS Issue Tracker] Issue Comment Edited: (ODATA-209) Replace the term store by service and reduce number of triggerpoints in diagrams in section Client Interaction inside ODQP proposal pages 5/6


    [ http://tools.oasis-open.org/issues/browse/ODATA-209?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=32116#action_32116 ] 

Stefan Drees edited comment on ODATA-209 at 1/24/13 5:51 AM:
-------------------------------------------------------------

I acknowledge the issue as applied in the current revision [OData Delta Query Protocol Design 2013-1-23.docx](https://www.oasis-open.org/committees/download.php/47996/OData%20Delta%20Query%20Protocol%20Design%202013-1-23.docx) . 

      was (Author: sdrees):
    Thanks a lot Mike for changing this already (in the upcoming revision). When I will have read that revision, I will edit this comment accordingly (to signal acknowledgment of application). 
  
> Replace the term store by service and reduce number of triggerpoints in diagrams in section Client Interaction inside ODQP proposal pages 5/6
> ---------------------------------------------------------------------------------------------------------------------------------------------
>
>                 Key: ODATA-209
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-209
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>    Affects Versions: WD01
>         Environment: [Proposed]
>            Reporter: Stefan Drees
>            Assignee: Michael Pizzo
>            Priority: Minor
>             Fix For: WD01
>
>
> Inside the current revision of the proposal for an OData Delta Query Protocol i.e. [OData Delta Query Protocol Design 2012-12-19.docx](https://www.oasis-open.org/committees/download.php/47755/OData%20Delta%20Query%20Protocol%20Design%202012-12-19.docx) there might be room for improvement of readability:
> In general I think the two terms "store" and "local store" might better not be used in parallel as they are in the text in section "Client Interaction" on pages 5 and 6.
> I suggest using "remote store" instead of "store" or where /if  this fact is opaque / or unimportant to the client better use "service" instead of "store".
> With respect to the two diagrams inside the section Client Interaction i.e. inside the subsection "Initial Population" on page 5 and "Result Maintenance" on page 6 it would in my opinion be beneficial to replace the label "Store" in the "scoping" box on the right-hand side with "Service".
> Also I think for these very top-level presentation of message/logic flow it might be better not to think of single/multiple page and last page result triggers, but only of not-last and last-page (since the delta link automatically starts at the first page.
> Thus I recommend changing the "More than one page?" 'DecisionDiamond' A) into 'Last page?' (identical to the trigger in the multi page case!) and B) adapt the yes/no "outcome-positions" i.e. "no" now to the left and "yes" to the bottom. This should render the flow much more readable and concentrates on the single trigger to act upon (from a client perspective) i.e. is the current response a last page with a new delta link or not?

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