search

w3c / json-ld-api

JSON-LD 1.1 Processing Algorithms and API Specification
https://w3c.github.io/json-ld-api/
Other
73 stars 29 forks source link

Inconsistent interface for Deserialize JSON-LD #579

Open jyasskin opened 7 months ago

jyasskin commented 7 months ago

https://www.w3.org/TR/json-ld-api/#deserialize-json-ld-to-rdf-algorithm says

This algorithm deserializes a JSON-LD document to an RDF dataset.

But the algorithm inside it says

The algorithm takes a map node map, which is the result of the Node Map Generation algorithm and an RDF dataset dataset into which new graphs and triples are added.

Those should be consistent.

gkellogg commented 7 months ago

We could update the introduction to say that the JSON-LD document is expected to be in the form of the map result of the Node Map Generation algorithm, but really the introduction is intended to be descriptive of the purpose of the algorithm, while the Algorithm itself, describes the expected inputs.