I need to go through the others, but for now....
On 6/8/15 12:49 PM, Antoine Isaac wrote:
> R-208: "A place for human-readable documentation for properties"
> http://lelystad.informatik.uni-mannheim.de/rdf-validation/?q=node/415
>
> The label is not very precise. We suggest "documentation of property
> usage from the perspective of the application profile."
>
> The scope could be broader, not only properties, but classes and maybe
> other elements, including constraints and axiom. But presently we can't
> really identify all these elements so we can't really name this broader
> scope. So we just suggest to postpone this.
How about just making this about having human-readable documentation of
all aspects of the AP? The way that I was thinking about this is quite
simply that the AP language would have properties for documentation
throughout -- like rdfs:comment but specifically something that you know
describes the aspect of the AP at that point - property, class, graph,
validation, whatever. We want to have a specific way to include comments
that are intended to be shown to programmer-users of the AP.
There's also perhaps another form of documentation that we might want,
and that is metadata creator documentation -- the documentation that
would be included in input forms, for example. "This field takes a date
in the form YYYY-MM-DD."
I don't know if these are two different kinds of comments, or if they
can be satisfied with a single property.
kc
--
Karen Coyle
[log in to unmask] http://kcoyle.net
m: 1-510-435-8234
skype: kcoylenet/+1-510-984-3600
|