w3c / w3c/json-ld-streaming

JSON-LD streaming document still mandating buffering the full file

Open
#54 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

ErratumRaised
Dominant language
HTML
Stars
15
Forks
3
PR merge metrics
No merged PRs in 30d

Description

JSON-LD content often use the layout following layout

{
   "@context": {...},
   "@graph": [...]
}

where @graph content should be in the default graph whereas in

{
   "@context": {...},
   "@graph": [...],
   "foo": "bar"
}

@graph content is in the named graph.

If I understand properly the JSON-LD streaming document, the parser have to buffer the full file to check if there is no @id or other key at the end of the file (in my example foo).

Am I correct in this interpretation?. If yes would it be worth it to make a new version of the JSON-LD streaming document that would mandate that the @graph key is always the last?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the JSON-LD streaming document and compare its processing rules against the two @graph layouts shown in the issue. Verify whether determining the graph requires seeing later keys, then document the conclusion and any agreed change to the streaming specification.

Written by the indexing model from the issue text.

Assessment

Tech stack
json
Domain
data
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.