[OASIS Issue Tracker] Updated: (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:all-tabpanel ]

Ralf Handl updated ODATA-382:
-----------------------------

    Proposal: 
Include section/subsection references for each conformance clause with a hyperlink to the appropriate section/subsection.

Accepted: https://www.oasis-open.org/committees/download.php/49325/odata-meeting-38_on-20130523-minutes.html#odata-382

  was:Include section/subsection references for each conformance clause with a hyperlink to the appropriate section/subsection.


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