#1150: [wg/json-ld] JSON-LD Working Group Charter

Visit on Github.

Opened Sep 10, 2025

This issue was created because the 'horizontal review requested' label was added to § https://github.com/w3c/strategy/issues/494

This review is requested prior to the Advisory Committee Review.

New charter proposal, reviewers please take note.

Charter Review

Charter

diff from charter template

Expected end of charter refinement phase: November 2025

If applicable:

diff from previous charter

chair dashboard

What kind of charter is this? Check the relevant box / remove irrelevant branches.

  • Existing
  • Existing WG recharter

Horizontal Reviews: apply the Github label "Horizontal review requested" to request reviews for accessibility (a11y), internationalization (i18n), privacy, security, and TAG. Also add a "card" for this issue to the Strategy Funnel.

Communities suggested for outreach

?

Known or potential areas of concern

  • JSON vs JSON-LD fracture in the data space
  • ?

Where would charter proponents like to see issues raised? (this strategy funnel issue, a different github repo, email, ...)

w3c/json-ld-charter-2025 issues

Anything else we should think about as we review?

cc @BigBlueHat

Charter facilitator(s)

cc @pchampin

<!-- Content below this is maintained by @w3c-tag-bot -->

Track conversations at https://tag-github-bot.w3.org/gh/w3ctag/design-reviews/1150

Discussions

Log in to see TAG-private discussions.

Discussed Sep 29, 2025 (See Github)

Jeffrey: The only point I know of where we disagree is whether we ask the WG to discuss the distinction between JSON and JSON-LD, whether we ask they do not, or we do nothing, or we note that the TAG disagrees. How do people feel?

Martin: I raised this because it's mentioned in the charter. By doing so, they did themselves a disserrvice because the spec is good on this point. I'd suggest they duck the issue. The work they're doing has done a good job.

https://www.w3.org/TR/2020/REC-json-ld11-20200716/#interpreting-json-as-json-ld

Jeffrey: Missing something in spec that says "here is how you decide to use this instead of JSON".

Sarven: This is where I'm not sure that the charter needs to address this. I like the idea about guidance, if they want to incorporate that into the spec or other documentation, but from the point of whether they need to make the case for JSON-LD at this point. EIther that case was already made, starting from incubation, etc... Lots of stuff already uses it. Don't need to rejustify JSON-LD and its existence. Maybe that guidance can be highlighted in this next spec version, that's fine.

Jeffrey: Fracture was mentioned in the review request. VC split into two because of this JSON vs -LD "split". I will probably make a comment as an AC rep about this; the fact that it has split a working group makes it our concern. That's why it should be in the charter. Not just because it exists, but they should document what should cause someone to use JSON or -LD in their work.

Sarven: Does the content/paragraph capture the recommendation we are trying to make?

Jeffrey: Sarven is saying that they should clarify. I'm saying that it should be in scope. The question is what should the TAG recommend they do.

Sarven: Does this explain why JSON-LD exists?

Martin: Question is, given an application, how would you decide that JSON-LD is the right choice, as opopsed to raw JSON. What's the processing model? All those questions need to be more thoroughly addressed in an application spec. Section 6.1 discusses how to treat JSON as JSON-LD.

Jeffrey: that question is that one I'd suggest they try to answer in their spec. They say that if you have linked data here is how you serialize that in JSON. That's not the use case that JSON-LD claims. Maybe consider the new use case that has appeared.

Sarven: It would be a good service to the community to include that in the spec. THen other people can use that in their work. To eliminate or elevate disputes. I'm OK with that. It's clear enough that we can . WIthin what we were thinking. Guidance to that extent is fine. I was more worried about justification.

Sarven: Would like to draft that. Do we need approval of that sentence. Was planning to post already.

Jeffrey: Would like to double-check, but feel like just the two of us are the only ones who need to approve it.

Comment by @csarven Oct 1, 2025 (See Github)

https://github.com/w3c/strategy/issues/494#issuecomment-3357514678

Comment by @csarven Oct 6, 2025 (See Github)

https://github.com/w3c/json-ld-charter-2025/pull/17