json-ld-api icon indicating copy to clipboard operation
json-ld-api copied to clipboard

Inconsistent interface for Deserialize JSON-LD

Open jyasskin opened this issue 1 year ago • 1 comments

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.

jyasskin avatar Nov 20 '23 22:11 jyasskin

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.

gkellogg avatar Nov 20 '23 23:11 gkellogg