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] Commented: (ODATA-83) Rewording of 4 Resource Path second paragraph for clarity and readability


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

Michael Pizzo commented on ODATA-83:
------------------------------------

Propose slight rewording:
- "Orders related to Customers in London" should be "Orders related to a single Customer", as the later better represents the types of URLs supported by an OData service.
-"service operations" should be "operations", as the former specific type of operations have been deprecated in favor of the general class of operations, including functions and actions.

Reworded:

`Any aspect of any resource exposed by an OData service MUST be addressable by a corresponding resource path URL component to enable interaction of the client with that resource aspect.` 

`To illustrate the context, some examples for resources might be: Customers, a single Customer, Orders related to a single Customer, and so forth. Examples of addressable aspects of these resources as exposed by the data model might be: collections of entities, a single entity, properties, Links, operations, and so on.` 

> Rewording of 4 Resource Path second paragraph for clarity and readability
> -------------------------------------------------------------------------
>
>                 Key: ODATA-83
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-83
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>          Components: OData URL Conventions v1.0
>    Affects Versions: WD01
>         Environment: [Proposed]
>            Reporter: Stefan Drees
>            Priority: Minor
>             Fix For: WD01
>
>
> Please consider splitting and rewriting the second of the two paragraphs:
> `The resource path section of a URL identifies the resource to be interacted with (such as Customers, a single Customer, Orders related to Customers in London, and so forth). The resource path enables any aspect of the data model (collections of entities, a single entity, properties, Links, service operations, and so on) exposed by an OData service to be addressed.`
> along the lines of the proposed rewording.

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