SEMICeu / style-guide

SEMIC style guide to create reusable vocabularies and application profiles
https://semiceu.github.io/style-guide/
Creative Commons Attribution 4.0 International
9 stars 2 forks source link

Style guide should encourage provision of examples/instance diagrams #52

Open tfrancart opened 1 year ago

tfrancart commented 1 year ago

Conceptual data model are hard to understand especially for business stakehoders. From my experience, an efficient way to convey the intended usage of a data model to business stakeholders or to developers is to provide examples / instances diagrams, along with the conceptual model and the ontology implementation.

I am concerned that the SEMIC style guide nowhere adresses the question of providing examples, e.g. it is not listed in the artifact types (https://semiceu.github.io/style-guide/public-review/arhitectural-clarifications.html#sec:artefact-types)

UML does offer ways to design instances diagrams, I think.

Were instances diagrams deliberatley left out of scope ?