dcmi / dcap

DC Tabular Application Profile - supporting materials
28 stars 12 forks source link

REQUIREMENT: Express semantics such as classes and relationships #43

Open nishad opened 5 years ago

nishad commented 5 years ago

Some straightforward option to notate rich semantics, which may be helpful in generating better documentation and class diagrams.

Sent with GitHawk

kcoyle commented 5 years ago

@nishad It probably will be necessary to specify what type of "classes" this refers to - for example RDF/OWL or O-O. They have considerably different semantics.

nishad commented 5 years ago

Anything, which can be mapped back to RDF or any form of RDF itself is better. Ultimately useful to generate parts of the documentation.

May be something simple like :

image

Or as complex as : image

kcoyle commented 5 years ago

Yes, but note that we are not specifying the AP as RDF, although RDF can be one of the models it will support. When it comes to features that are specific to a data model (whether CSV, XML, RDF, or whatever) we may need to extend the vocabulary to include features that are not "universal". This is something we need to think about. I'll try to create an issue that will keep this in our sights.

nishad commented 5 years ago

The point is, If the application profile can be used to generate minimal documentation, specifically class diagrams, etc.

kcoyle commented 5 years ago

Actually, it would be useful to create this as a use case, please. And give as much detail as you can, along with an example. That will make the requirement more concrete, and people can extrapolate from that to their own preferred schema and documentation type. Thanks.