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