w3c-ccg / traceability-vocab

A traceability vocabulary for describing relevant Verifiable Credentials and their contents.
https://w3id.org/traceability
Other
35 stars 35 forks source link

Remove $linkedData #948

Open OR13 opened 3 months ago

OR13 commented 3 months ago

Reasoning:

We originally developed this syntax to blend JSON-LD into JSON Schema.

We've gathered a lot of experience with this, throughout this project.

I think we have learned the following:

  1. Inline JSON-Schema is better that multi file / ref based (when consuming, not necessarily when producing).

  2. JSON-LD and RDF terminology design are easier to do in isolation, than when blended with YAML or JSON Schema.

  3. Term definitions can be added over time, for terms that are actually useful... We don't need to generate documentation for terminology that nobody finds useful.

I'd like to propose we simplify the vocabulary, and modularize it, and remove the polyglotting which probably makes contribution and review very difficult for experts.

VladimirAlexiev commented 1 month ago

@OR13 While editing GLEI schemas, I found it difficult to fix problems because there's a lot of repetition of examples. So making editing more modular is a worthy goal. But then what editorial procedures to use for binding to Linked Data?

OR13 commented 1 month ago

Perhaps the answer should be a context per credential type.