Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Make the distinction between ordered and unordered collections and relationships #14

Open
jdvorak001 opened this issue Nov 13, 2023 · 1 comment

Comments

@jdvorak001
Copy link
Member

In some contexts, ordering of elements in a collection is important, e.g. keywords or authors of a document.
In other contexts, ordering is not important: e.g. contacts.

A convention should be introduced for the Markdown files.
This should then be somehow represented in the PlantUML diagrams and also in the generated ontology.

@jdvorak001
Copy link
Member Author

In Markdown files:

  • For attributes: use List<...> or Set<...>
  • For relationships: At the end of the relationship paragraph, add the sentence "These are ordered." in case the order is important. If it is not important, nothing is added to the paragraph.

In PlantUML files:

  • For attributes: use List<...> or Set<...>
  • For relationships: Add <<ordered>> to the role in the direction where the ordering is important.

This translates into the ontology as follows:

  • Single-valued properties are FunctionalProperties
  • Unordered multi-valued properties are just properties.
  • Ordered multi-valued properties have a domain of rdf:List. An additional SHACL shape could constrain the types of the elements.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant