Skip to content

Document slot_uri override rationale in schema annotations #102

@StroemPhi

Description

@StroemPhi

Affected: chemical_entities_ap.yaml, chemical_reaction_ap.yaml, material_entities_ap.yaml
Severity: Documentation
Status: Not started

Problem: ChemDCAT-AP's YAML schema files use SIO:000008 instead of DCAT-AP+'s default dcterms:relation on attribute sub-slots, but no notes or comments annotation in the schema explains why. A developer reading only the schema (without the docs) sees the discrepancy without understanding the rationale.

Fix: Add notes annotations on affected slots explaining the override rationale (BFO alignment, OWL DL annotation property conflict avoidance, semantic precision).

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions