[OASIS Issue Tracker] Commented: (ODATA-26) Feedback to document revision

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

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

Stefan Drees commented on ODATA-26:
-----------------------------------

Note: A HTML-version of these comments will be made available at URL=LATER_MORE and in the hope, that it helps those that find markdown a bit less readable than the rendered version. 

Thanks a lot for providing this first draft, Mike! 

As already practiced with the other document revision issues, I prefer to put my complete feedback of the first iteration into one comment, so that you may consider it as a whole and we do not drown in a flood of minor issues on a phrase level of the documents. 

If there is interest in or objection against specific feedback items, I will be happy to invest the extra work and pull these into dedicated JIRA issues. 

Comments are structured by bracketing the location range in the document revision [OData URL Conventions Version 1.0 Working Draft 01](https://www.oasis-open.org/committees/download.php/46751/odata-url-conventions-v1.0-wd01-2012-08-22.doc) and then detailing this in globally enumerated feedback items (currently A-A). 


Review iteration is paused.

#2 URL Components#

##Feedback A)##

The second of the two examples after:

`The following are two example URLs broken down into their component parts:`

does not show the alignment between the sample url and the illustrative range bracketing and labeling.

This **SHOULD** be rearranged.

Benefit is `readability`


 

#Session paused#

> Feedback to document revision
> -----------------------------
>
>                 Key: ODATA-26
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-26
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Improvement
>          Components: OData URL Conventions v1.0
>            Reporter: Stefan Drees
>            Assignee: Ralf Handl
>            Priority: Minor
>
> Several feedback items have been identified. These are listed in the comment as one document since they are partially related and to not flood the editor with N  isolated issues.

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