Skip to content

Decide between rdf:Statement and tr:MappingAssertion for mapping reification #135

Description

@maehr

Question

Should MappingAssertion expand to a bare rdf:Statement, or to tr:MappingAssertion rdfs:subClassOf rdf:Statement?

#127 maps the term straight to rdf:Statement. That choice has a cost on each side, so it needs a decision record rather than a silent default.

Trade-off

Bare rdf:Statement (the current choice):

  • A generic reification consumer matches rdf:type rdf:Statement with no inference.
  • Nothing in RDF separates a curated, sourced, lifecycle-managed TextRefs mapping from any other reified statement.
  • MappingAssertion disappears from /ontology/, while Specification §10 still centres on it.

tr:MappingAssertion rdfs:subClassOf rdf:Statement:

  • The class keeps the TextRefs meaning and gets a definition at /ontology/.
  • A consumer without a reasoner no longer matches rdf:type rdf:Statement.

Also to record

RDF 1.2 deprecates the reification vocabulary in favour of triple terms. The decision record should state how TextRefs plans to migrate.

Suggested action

Write an ADR under decisions/. Raised during review of #127 and deferred to keep that PR lean.

Activity

  1. added
    adrArchitecture Decision Record
    standardThe published specification and schemas
    on Sep 2, 2026
  2. maehr commented on Sep 2, 2026

    @maehr
    MemberAuthor

    Reduced in scope rather than decided.

    #127 no longer reifies MappingAssertion. The context keeps tr:MappingAssertion, and #127 defines that class in the published ontology. No ADR is needed now.

    This issue stays open as the question it always was: whether a later context version should express a mapping as an rdf:Statement. Reopen the design work when there is a consumer that needs it. Note that RDF 1.2 deprecates the reification vocabulary in favour of triple terms, so the answer may be neither.

  3. maehr commented on Sep 2, 2026

    @maehr
    MemberAuthor

    Closing. #127 keeps tr:MappingAssertion and defines it in the published ontology, so no decision is outstanding. Raise a new issue if a consumer ever needs a mapping expressed as an rdf:Statement.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    adrArchitecture Decision RecordstandardThe published specification and schemas

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions