Skip to content
This repository was archived by the owner on Sep 23, 2025. It is now read-only.

Commit 45f0bcb

Browse files
authored
Merge branch 'json-ld-wg' into yaml-justification
2 parents 350d7fe + 5d3f0ba commit 45f0bcb

File tree

1 file changed

+100
-71
lines changed

1 file changed

+100
-71
lines changed

2024/json-ld-wg/index.html

Lines changed: 100 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@
5555
<li><a href="#background">Background</a></li>
5656
<li><a href="#scope">Scope</a></li>
5757
<li><a href="#deliverables">Deliverables</a></li>
58-
<li><a href="#success-criteria">Success Criteria</a></li>
58+
<li><a href="#success-criteria">Success Criteria</a></li>
5959
<li><a href="#coordination">Coordination</a></li>
6060
<li><a href="#participation">Participation</a></li>
6161
<li><a href="#communication">Communication</a></li>
@@ -73,15 +73,20 @@
7373

7474
<main>
7575
<h1 id="title"><i class=todo>DRAFT</i> JSON-LD Working Group Charter</h1>
76+
<!-- replace DRAFT with PROPOSED when the AC review starts -->
77+
<!-- delete PROPOSED after AC review completed -->
7678

7779
<p class="mission">The <strong>mission</strong> of the <a href="https://www.w3.org/groups/wg/json-ld">JSON-LD Working Group</a> is to maintain and extend the <a href="https://www.w3.org/groups/wg/json-ld/publications">family of JSON-LD 1.1 Recommendations</a> and related Working Group Notes.</p>
7880

7981
<div class="noprint">
8082
<p class="join"><a href="https://www.w3.org/groups/wg/json-ld/join">Join the JSON-LD Working Group.</a></p>
8183
</div>
8284

85+
<!-- replace "draft charter" with "proposed charter" when the AC review starts -->
86+
<!-- replace GitHub link and issues link to the specific charter in GH and its issues repo -->
87+
<!-- delete the GH link after AC review completed -->
8388
<p class=todo style="padding: 0.5ex; border: 1px solid green">
84-
This proposed charter is available on <a href="https://github.com/json-ld/json-ld-wg-charter">GitHub</a>.
89+
This draft charter is available on <a href="https://github.com/json-ld/json-ld-wg-charter">GitHub</a>.
8590
Feel free to raise <a href="https://github.com/json-ld/json-ld-wg-charter/issues">issues</a>.
8691
</p>
8792

@@ -147,15 +152,20 @@ <h2>Motivation and Background</h2>
147152
JSON-LD (JavaScript Object Notation for Linked Data) is a widely used method of encoding Linked Data using JSON.
148153
Use of JSON-LD has grown and expanded over the last decade (since it's first publication as a
149154
<a href="https://www.w3.org/TR/json-ld-api1/">W3C Recommendation in 2014</a>).
150-
JSON-LD remains a popular choice for ecoding <abbr title="Seach Engine Optimization">SEO</abbr>-focused
151-
structured data in Web pages. JSON-LD has also become a foundational format for social media (ActivityStreams),
152-
Internet of Things data (Web of Things Description), Verifiable Credentials, and Software Bill of Materials (SPDX).
155+
JSON-LD remains a popular choice for encoding <abbr title="Seach Engine Optimization">SEO</abbr>-focused
156+
structured data in Web pages. JSON-LD has also become a foundational format for social media
157+
(<a href="https://www.w3.org/TR/activitystreams-core/">ActivityStreams</a>),
158+
Internet of Things data (<a href="https://www.w3.org/TR/wot-thing-description11/">Web of Things Description</a>),
159+
<a href="https://www.w3.org/TR/vc-data-model-2.0/">Verifiable Credentials</a>, and Software Bill of Materials
160+
(<a href="https://spdx.github.io/spdx-spec/v3.0.1/serializations/#serialization-in-json-ld">SPDX</a>).
153161
</p>
154162
<p>This growth in the applied use of JSON-LD has resulted in community interest in additional expressions of
155-
JSON-LD's underlying Linked Data structure into other formats. YAML-LD has been created by the
163+
JSON-LD's underlying Linked Data structure in other formats. YAML-LD has been created by the
156164
<a href="https://www.w3.org/community/json-ld/">JSON for Linking Data Community Group</a> for easing human
157165
authoring and providing a clearer path for using Linked Data applied to popular YAML-based documents such as
158-
infrastructure as code, static site front matter, and API documentation formats.
166+
infrastructure as code, static site front matter, and API documentation formats. Additionally, a need arose
167+
in the Verifiable Credentials space for providing a more compressed expression of JSON-LD, and work on
168+
CBOR-LD was begun in the JSON-LD CG.
159169
</p>
160170

161171
<p>
@@ -170,8 +180,8 @@ <h2>Motivation and Background</h2>
170180
</p>
171181

172182
<p>
173-
The hope of this new more inclusively focused JSON-LD WG is to meet the demand of the broader
174-
JSON-LD community by strengthening the foundational JSON-LD specifications and aligning it with the latest
183+
The goal of this new more inclusively focused JSON-LD WG is to meet the demand of the broader
184+
JSON-LD community by strengthening the foundational JSON-LD specifications and aligning them with the latest
175185
RDF 1.2 specifications, growing the family of JSON-LD related formats which orbit around the JSON-LD
176186
processing model, and specifying improved context retrieval methods for greater clarity and stability.
177187
</p>
@@ -184,7 +194,8 @@ <h2>Scope</h2>
184194
with the features introduced by <a href="https://www.w3.org/TR/rdf12-concepts">RDF 1.2</a>
185195
in addition to open Errata and requested features
186196
as noted on the groups <a href="https://github.com/orgs/w3c/projects/84">Project Management Page</a>.
187-
These specifications together provide a JSON format for Linked Data to interoperate in a method which is familiar to and usable by software engineers.
197+
Together, these specifications provide a JSON format for Linked Data,
198+
enabling interoperation in a way which is familiar to and usable by software engineers.
188199
<!-- Note that the JSON-LD APIs are not browser specific; while appropriate for use within browsers, they are not limited to such use, and there is no requirement for browsers to implement them natively. -->
189200
</p>
190201
<p>
@@ -222,7 +233,8 @@ <h2>
222233

223234
<p>Updated document status is available on the <a href="https://www.w3.org/groups/wg/json-ld/publications">group publication status page</a>.</p>
224235

225-
<p><i>Draft state</i> indicates the state of the deliverable at the time of the charter approval.</p>
236+
<p><i>Draft state</i> indicates the state of the deliverable at the time of the charter approval.
237+
<i>Expected completion</i> indicates when the deliverable is projected to become a Recommendation, or otherwise reach a stable state.</p>
226238

227239
<section id="normative">
228240
<h3>
@@ -232,61 +244,69 @@ <h3>
232244
The Working Group will deliver the following W3C normative specifications:
233245
</p>
234246
<dl>
235-
<dt><strong>JSON-LD 1.2</strong></dt>
236-
<dd>
237-
Draft State: W3C Recommendation<br>
238-
Reference Draft: <a href="https://www.w3.org/TR/2020/REC-json-ld11-20200716/">https://www.w3.org/TR/2020/REC-json-ld11-20200716/</a><br>
239-
Latest publication: 07 May 2020<br>
240-
Associated <a href="https://lists.w3.org/Archives/Member/member-cfe/2020Mar/0005.html">Call for Exclusion</a> 5 March 2020, ended on 4 May 2020<br>
241-
Produced under Working Group Charter: <a href="https://www.w3.org/2018/03/jsonld-wg-charter.html">https://www.w3.org/2018/03/jsonld-wg-charter.html</a>
242-
</dd>
243-
<dt><strong>JSON-LD 1.2 Processing Algorithms and API</strong></dt>
244-
<dd>
245-
Draft State: W3C Recommendation<br>
246-
Reference Draft: <a href="https://www.w3.org/TR/2020/REC-json-ld11-api-20200716/">https://www.w3.org/TR/2020/REC-json-ld11-api-20200716/</a><br>
247-
Latest publication: 07 May 2020<br>
248-
Associated <a href="https://lists.w3.org/Archives/Member/member-cfe/2020Mar/0004.html">Call for Exclusion</a> 5 March 2020, ended on 4 May 2020<br>
249-
Produced under Working Group Charter: <a href="https://www.w3.org/2018/03/jsonld-wg-charter.html">https://www.w3.org/2018/03/jsonld-wg-charter.html</a>
250-
</dd>
251-
<dt><strong>JSON-LD 1.2 Framing</strong></dt>
252-
<dd>
253-
Draft State: W3C Recommendation<br>
254-
Reference Draft: <a href="https://www.w3.org/TR/2020/REC-json-ld11-framing-20200716/">https://www.w3.org/TR/2020/REC-json-ld11-framing-20200716/</a><br>
255-
Latest publication: 07 May 2020<br>
256-
Associated <a href="https://lists.w3.org/Archives/Member/member-cfe/2019Dec/0003.html">Call for Exclusion</a> 12 December 2019, ended on 10 February 2020<br>
257-
Produced under Working Group Charter: <a href="https://www.w3.org/2018/03/jsonld-wg-charter.html">https://www.w3.org/2018/03/jsonld-wg-charter.html</a>
258-
</dd>
259-
</dl>
260-
<p>
261-
The Working Group will also deliver the following W3C normative specifications:
262-
</p>
263-
<dl>
264-
<dt><strong>CBOR-LD 1.0</strong></dt>
265-
<dd>
266-
<p>CBOR is a compact binary data serialization and messaging format. This specification defines CBOR-LD, a CBOR-based format to serialize Linked Data. The encoding is designed to leverage the existing JSON-LD ecosystem, to provide a compact serialization format for those seeking efficient encoding schemes for Linked Data.</p>
267-
<p>
268-
<div><b>Input documents:</b>
269-
<ul>
270-
<li><a href="https://json-ld.github.io/cbor-ld-spec/">CBOR-LD</a>,
271-
<i class=todo>Final Community Group Report</i> (<i class=todo>2024-xx-xx</i>), adopted from the JSON for Linking Data Community Group
272-
<li><a href="https://w3c.github.io/json-ld-cbor/">JSON-LD 1.1. in CBOR</a>,
273-
Editor's Draft (2022-12-06), adopted from previous JSON-LD Working Group
274-
</ul>
275-
</div>
276-
<p><b>Expected completion:</b> CR in Q4 2026</p>
277-
</dd>
278-
<dt><strong>YAML-LD 1.0</strong></dt>
279-
<dd>
280-
<p>This document defines YAML-LD, a set of conventions built on top of YAML, which outlines how to serialize Linked Data as YAML based on JSON-LD syntax, semantics, and APIs.</p>
281-
<p><b>Input document:</b>
282-
<a href="https://www.w3.org/community/reports/json-ld/CG-FINAL-yaml-ld-20231206/">YAML-LD</a>,
283-
Final Community Group Report (2023-12-06), adopted from the JSON for Linking Data Community Group
284-
</p>
285-
<p><b>Expected completion:</b> CR in Q4 2026</p>
286-
</dd>
287-
</dl>
247+
<dt id="json-ld-12" class="spec">JSON-LD 1.2</dt>
248+
<dd>
249+
<p>This specification will define a new version of JSON-LD, fully compatible with <a href="https://www.w3.org/TR/rdf12-concepts">RDF 1.2</a>.</p>
250+
251+
<p class="draft-status"><b>Draft state:</b> <a href="https://www.w3.org/TR/TR/json-ld11">Adopted from JSON-LD 1.1 Recommendation</a>.</p>
252+
253+
<p class="milestone"><b>Expected completion:</b> Q4 2027.</p>
254+
255+
<p><b>Adopted Draft:</b> JSON-LD 1.1, <a href="https://www.w3.org/TR/2020/REC-json-ld11-20200716/">https://www.w3.org/TR/2020/REC-json-ld11-20200716/</a>, 16 July 2020.</p>
256+
257+
<p><b>Exclusion Draft:</b> JSON-LD 1,1, <a href="https://www.w3.org/TR/2020/CR-json-ld11-20200305/">https://www.w3.org/TR/2020/CR-json-ld11-20200305/</a>, 5 March 2020. Exclusion period <b>2020-03-05</b>; Exclusion period <b>2020-05-04</b>.</p>
258+
259+
<p><b>Exclusion Draft Charter:</b> <a href="https://www.w3.org/2018/03/jsonld-wg-charter.html">https://www.w3.org/2018/03/jsonld-wg-charter.html</a>.</p>
260+
</dd>
261+
262+
<dt id="json-ld-api-12" class="spec">JSON-LD 1.2 Processing Algorithms and API</dt>
263+
<dd>
264+
<p>This specification will define new version of JSON-LD Processing Algorithms and API, fully compatible with <a href="https://www.w3.org/TR/rdf12-concepts">RDF 1.2</a>.</p>
265+
266+
<p class="draft-status"><b>Draft state:</b> <a href="https://www.w3.org/TR/json-ld11-api/">Adopted from JSON-LD 1.1 Processing Algorithms and API Recommendation</a>.</p>
267+
268+
<p class="milestone"><b>Expected completion:</b> Q4 2027.</p>
269+
270+
<p><b>Adopted Draft:</b> JSON-LD 1.1, <a href="https://www.w3.org/TR/2020/REC-json-ld11-api-20200716/">https://www.w3.org/TR/2020/REC-json-ld11-api-20200716/</a>, 16 July 2020.</p>
271+
272+
<p><b>Exclusion Draft:</b> JSON-LD 1,1, <a href="https://www.w3.org/TR/2020/CR-json-ld11-api-20200305/">https://www.w3.org/TR/2020/CR-json-ld11-api-20200305/</a>, 5 March 2020. Exclusion period <b>2020-03-05</b>; Exclusion period <b>2020-05-04</b>.</p>
273+
274+
<p><b>Exclusion Draft Charter:</b> <a href="https://www.w3.org/2018/03/jsonld-wg-charter.html">https://www.w3.org/2018/03/jsonld-wg-charter.html</a>.</p>
275+
</dd>
276+
288277

278+
<dt id="json-ld-framing-12" class="spec">JSON-LD 1.2 Framing</dt>
279+
<dd>
280+
<p>This specification will define new version of JSON-LD Framing, fully compatible with <a href="https://www.w3.org/TR/rdf12-concepts">RDF 1.2</a>.</p>
289281

282+
<p class="draft-status"><b>Draft state:</b> <a href="https://www.w3.org/TR/json-ld11-framing/">Adopted from JSON-LD 1.1 Framing Recommendation</a>.</p>
283+
284+
<p class="milestone"><b>Expected completion:</b> Q4 2027.</p>
285+
286+
<p><b>Adopted Draft:</b> JSON-LD 1.1, <a href="https://www.w3.org/TR/2020/REC-json-ld11-framing-20200716/">https://www.w3.org/TR/2020/REC-json-ld11-framing-20200716/</a>, 16 July 2020.</p>
287+
288+
<p><b>Exclusion Draft:</b> JSON-LD 1,1, <a href="https://www.w3.org/TR/2020/CR-json-ld11-framing-20200305/">https://www.w3.org/TR/2020/CR-json-ld11-framing-20200305/</a>, 5 March 2020. Exclusion period <b>2020-03-05</b>; Exclusion period <b>2020-05-04</b>.</p>
289+
290+
<p><b>Exclusion Draft Charter:</b> <a href="https://www.w3.org/2018/03/jsonld-wg-charter.html">https://www.w3.org/2018/03/jsonld-wg-charter.html</a>.</p>
291+
</dd>
292+
293+
<!-- ********************** -->
294+
<dt id="yaml-ld-10" class="spec">YAML-LD 1.0</dt>
295+
<dd>
296+
<p>This document defines YAML-LD, a set of conventions built on top of YAML, which outlines how to serialize Linked Data as YAML based on JSON-LD syntax, semantics, and APIs.</p>
297+
298+
<p class="draft-status"><b>Draft state:</b> <a href="https://www.w3.org/community/reports/json-ld/CG-FINAL-yaml-ld-20231206/">YAML-LD</a>, Final Community Group Report (2023-12-06), adopted from the JSON for Linking Data Community Group.</p>
299+
<p class="milestone"><b>Expected completion:</b> Q1 2027.</p>
300+
</dd>
301+
302+
<dt id="cbor-ld-10" class="spec">CBOR-LD 1.0</dt>
303+
<dd>
304+
<p>This specification defines CBOR-LD, a CBOR-based format to serialize Linked Data. The encoding is designed to leverage the existing JSON-LD ecosystem, to provide a compact serialization format for those seeking efficient encoding schemes for Linked Data.</p>
305+
306+
<p class="draft-status"><b>Draft state:</b> <a href="https://json-ld.github.io/cbor-ld-spec/">CBOR-LD</a>, Community Group Draft Report (2025-05-09), adopted from the JSON for Linking Data Community Group.</p>
307+
<p class="milestone"><b>Expected completion:</b> Q1 2027.</p>
308+
</dd>
309+
</dl>
290310
</section>
291311

292312
<section id="ig-other-deliverables">
@@ -350,8 +370,11 @@ <h3>Timeline</h3>
350370
<section id="success-criteria">
351371
<h2>Success Criteria</h2>
352372

353-
<p>In order to advance to <a href="https://www.w3.org/policies/process/#RecsPR" title="Proposed Recommendation">Proposed Recommendation</a>, each normative specification is expected to have <a href="https://www.w3.org/policies/process/#implementation-experience">at least two independent interoperable implementations</a> of every feature defined in the specification, where interoperability can be verified by passing open test suites.</p>
373+
<p>In order to advance beyond
374+
<a href="https://www.w3.org/policies/process/#RecsCR" title="Candidate Recommendation">Candidate Recommendation</a>, each normative specification is expected to have <a href="https://www.w3.org/policies/process/#implementation-experience">at least two independent interoperable implementations</a> of every feature defined in the specification, where interoperability can be verified by passing open test suites. In order to advance beyond Candidate Recommendation, each normative specification must have an open test suite of every feature defined in the specification.</p>
375+
354376
<p>There should be testing plans for each specification, starting from the earliest drafts.</p>
377+
355378
<p>To promote interoperability, all changes made to specifications
356379
in Candidate Recommendation
357380
or to features that have deployed implementations
@@ -362,10 +385,13 @@ <h2>Success Criteria</h2>
362385

363386
<p>Each specification should contain separate sections detailing all known security and privacy implications for implementers, Web authors, and end users.</p>
364387

365-
<!-- Design principles -->
366-
<p>This Working Group expects to follow the
367-
TAG <a href="https://www.w3.org/TR/design-principles/">Web Platform Design Principles</a>.
368-
</p>
388+
<!-- W3C Statements and Web Platform Design Principles -->
389+
<p>This group is expected to be guided by the following documents:</p>
390+
<ul>
391+
<li><a href="https://www.w3.org/TR/ethical-web-principles/">Ethical Web Principles</a>,</li>
392+
<li><a href="https://www.w3.org/TR/privacy-principles/">Privacy Principles</a>,</li>
393+
<li><a href="https://www.w3.org/TR/design-principles/">Web Platform Design Principles</a>.</li>
394+
</ul>
369395

370396
</section>
371397

@@ -417,10 +443,13 @@ <h2 id="participation">
417443
</p>
418444
<p>
419445
The group encourages questions, comments and issues on its public mailing lists and document repositories, as described in <a href='#communication'>Communication</a>.
446+
The group also welcomes non-Members to contribute technical submissions for consideration upon their agreement to the terms of the <a href="https://www.w3.org/policies/patent-policy/">W3C Patent Policy</a>.
420447
</p>
448+
421449
<p>
422-
The group also welcomes non-Members to contribute technical submissions for consideration upon their agreement to the terms of the <a href="https://www.w3.org/policies/patent-policy/">W3C Patent Policy</a>.
450+
The Chairs should periodically look through the non-Members who have contributed to the Working Group or the JSON for Linking Data Community Group and consider whether each one should be invited to participate as an <a href="https://www.w3.org/invited-experts/">Invited Expert</a>. If a non-Member contributor would like to participate in meetings, they are encouraged to <a href="https://www.w3.org/groups/wg/json-ld/instructions/">apply to be an Invited Expert</a>.
423451
</p>
452+
424453
<p>Participants in the group are required (by the <a href="https://www.w3.org/policies/process/#ParticipationCriteria">W3C Process</a>) to follow the
425454
W3C <a href="https://www.w3.org/policies/code-of-conduct/">Code of Ethics and Professional Conduct</a>.</p>
426455
</section>
@@ -436,7 +465,7 @@ <h2>
436465
The meetings themselves are not open to public participation, however.
437466
</p>
438467
<p>
439-
Information about the group (including details about deliverables, issues, actions, status, participants, and meetings) will be available from the <a href="">JSON-LD Working Group home page.</a>
468+
Information about the group (including details about deliverables, issues, actions, status, participants, and meetings) will be available from the <a href="https://www.w3.org/groups/wg/json-ld">JSON-LD Working Group home page.</a>
440469
</p>
441470
<p>
442471
Most JSON-LD Working Group teleconferences will focus on discussion of particular specifications, and will be conducted on an as-needed basis.

0 commit comments

Comments
 (0)