[ http://tools.oasis-open.org/issues/browse/ODATA-360?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Ralf Handl updated ODATA-360:
-----------------------------
Proposal:
Remove the <documentation> element from CSDL and define a documentation term in the core vocabulary. See also ODATA-361
<Term Name="Description" Type="Edm.String">
<Annotation Term="Core.Description" String="A brief description of a model element" />
</Term>
<Term Name="LongDescription" Type="Edm.String">
<Annotation Term="Core.Description" String="A lengthy description of a model element" />
</Term>
was:Remove the <documentation> element from CSDL and define a documentation term in the core vocabulary.
> Remove edm:documentation element from [CSDL]
> --------------------------------------------
>
> Key: ODATA-360
> URL: http://tools.oasis-open.org/issues/browse/ODATA-360
> Project: OASIS Open Data Protocol (OData) TC
> Issue Type: Bug
> Components: OData CSDL
> Affects Versions: V4.0_WD01
> Environment: [Resolved]
> Reporter: Michael Pizzo
> Fix For: V4.0_WD01
>
>
> OData V1 introduced a <Documentation> element in order to annotate a model element with a description.
> This is an ideal application of annotations, we just didn't have one defined at the time.
> We should not get rid of the <documentation> element and instead define a documentation annotation in the core vocabulary.
--
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
