[OASIS Issue Tracker] Issue Comment Edited: (ODATA-382) Conformance clauses need to refer to sections defining aspects of conformance and do so uniformly

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

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

Stefan Drees edited comment on ODATA-382 at 6/17/13 4:55 AM:
-------------------------------------------------------------

Reference to meeting #41 minute link fragment documenting the approval of application has been added.


      was (Author: sdrees):
    TODO Reference to meeting #41 minute link fragment will follow when it is available.
  
> Conformance clauses need to refer to sections defining aspects of conformance and do so uniformly
> -------------------------------------------------------------------------------------------------
>
>                 Key: ODATA-382
>                 URL: http://tools.oasis-open.org/issues/browse/ODATA-382
>             Project: OASIS Open Data Protocol (OData) TC
>          Issue Type: Bug
>          Components: OData ATOM Format , OData JSON Format, OData Protocol 
>    Affects Versions: V4.0_CSD01
>         Environment: [Applied]
>            Reporter: Patrick Durusau
>            Assignee: Michael Pizzo
>             Fix For: V4.0_CSD02
>
>
> Some conformance clauses in ODATA CSDL have hyperlinks to other parts of CSDL and others do not. Hyperlinks are useful but explicit references to the sections in question + hyperlinks would be better. And either way, they need to be uniform for all conformance clauses.
> As an editorial nit, I would number all the sub-clauses for conformance. 
> Another editorial nit, I would not mix must, must not and should clauses. 
> Need to review for consistency, see: return 501 Not Implemented for any unsupported functionality (with a hyperlink under minimal conformance) versus 501 Not Implemented for any unsupported functionality (no hyperlink under intermediate conformance)
> FYI, I have not compared the content of the conformance clauses to the sections that define them for this issue. 

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