The W3C JSON-LD Community Group

Go Back


W3C Logo

JSON-LD CG

Minutes for 2024-07-10

Gregg Kellogg:
Gregg Kellogg is scribing.

Topic: Announcements and Introductions

Topic: CBOR-LD

David I. Lehn: We haven't worked on the spec too much, but are working on our implementation. We need to find time to update the spec.
David I. Lehn: We're moving some things forward and have a PR pending.
... Needs IANA registration.
Gregg Kellogg: Probably a WG item; needs to be in the spec.
David I. Lehn: We have other IDs, not yet registered, that need to go in.
... Part of the binary format.
https://github.com/json-ld/cbor-ld-spec/pull/28 -> Pull Request 28 Add support for different CBOR tags to be used for CBOR-LD to identify required application context maps. (by wes-smith)
Gregg Kellogg: Do we need to think about moving registries into the w3c github project.
Gregg Kellogg: This is an issue for the WG to take up.
... Both YAML-LD and CBOR-LD should move to the w3c space.
... Something for the WG to take up.
David I. Lehn: Doesn't really matter where it is as a practical matter.

Topic: YAML-LD

Anatoly Scherbakov: I created an issue on JSON-LD to call on a better definition on JSON serialization.
... Calling attention to the group.
... I also implemented more tests for YAML-LD, including YAML-LD contexts.
... I'd like to ask dlehn on what the plans are for PyLd? Is it actively developed? What are the next steps?
David I. Lehn: This is an issue of not having enough time for all the things we're doing.
... We'd like to make it easier for people to assist, but haven't figured out the time.
... We're seeing other pressure to update it.
... For example, the safe mode proposal that we feel is important.
... Needs an issue for behavior.
... Our JavaScript code is probably too involved.
Gregg Kellogg: Can you create a tracking issue in json-ld-api?
David I. Lehn: There are some test suite cases that need to be fixed for this.
... The Python and JavaScript versions have diverged.
Ted Thibodeau Jr.: Don't think you need to put in everything. Some words to trigger your memory are sufficient.
Benjamin Young: We've been working with the active py community who depends on PyLd.
... We having a growing community of interest, which will make it more of a priority to address.
... It impacts Verifiable Credentials implementations.

Topic: CBOR-LD

David I. Lehn: While I was looking into things, I found this paper which seems pertinent.
... Probalby worth talking with them.
Gregg Kellogg: The WG should invite them to participate.
Ted Thibodeau Jr.: Whoever contacts the CBL authors, they should be pointed to the Web Of Things CG and WG.
Ted Thibodeau Jr.: WoT CG — https://www.w3.org/groups/cg/wot/
Ted Thibodeau Jr.: WoT WG — https://www.w3.org/groups/wg/wot/

Topic: JSON-LD Issue Discussion

Subtopic: Status of charter update

Benjamin Young: No progress. I had posted an issue on the charter repo.
Pierre-Antoine Champin: I did some changes to the charter to address pending issues. (bigblue hat, please review).
... In my view, when we solve this pending PR we can move forward with the charter.
Benjamin Young: The WoT WG is listed, but not the CG.
... Please check for other groups that should be listed.

Subtopic: issue w3c/json-ld-api#603

https://github.com/w3c/json-ld-api/issues/603 -> Issue 603 toRdf() and flatten() API require extractAllScripts to default to true (by gkellogg) [spec:enhancement] [needs discussion] [ErratumRaised]
Anatoly Scherbakov: Dlehn I wouldn't like to distract everyone as this is probably off-topic, but the issue I am facing now with python-yaml-ld is that I am redoing a lot of stuff that pyld already is doing. Basically, pyld already implements everything that's needed except a special DocumentLoader. So ideally, it feels like there shouldn't be a separate library for
Anatoly Scherbakov: YAML-LD at all, it should be just a feature of pyld. But in addition to that I would like to see improvements like pytest-based testing framework and better mypy/typing support. So I am still working on this as a separate implementation but it, kind of, feels wrong.
Gregg Kellogg: Probably need to update the API to default to true, but unfortunate.
Pierre-Antoine Champin: Do we have text which is inconsistent with tests?
Pierre-Antoine Champin: Sounds good to me
Gregg Kellogg: My thought is to change API for toRDF but not flatten.
Ted Thibodeau Jr.: I think tests are editable, if incorrect.
... We should fix the test suite, if its wrong.
... Implementations may need to be changed, but this should have been reported as a bug.
Pierre-Antoine Champin: That's what we have in rdf-canon: https://w3c.github.io/rdf-canon/spec/#h-note-3
PROPOSAL: update tests for flatten to assume extractAllScripts defaults to false. Update toRdf() API to set default for extractAllScripts to true.
Gregg Kellogg: +1
Anatoly Scherbakov: +1
Ted Thibodeau Jr.: +1
Pierre-Antoine Champin: +1
Niklas Lindström: +0 (Haven't thought it through fully)
David I. Lehn: +0
Niklas Lindström: Probably makes sense; so +ITY ;)
RESOLUTION: update tests for flatten to assume extractAllScripts defaults to false. Update toRdf() API to set default for extractAllScripts to true.

Subtopic: issue w3c/json-ld-api#604

https://github.com/w3c/json-ld-api/issues/604 -> Issue 604 Using flatten() on HTML input having a single script element with an object with `@graph` results in named graph (by gkellogg) [spec:enhancement] [needs discussion] [ErratumRaised]
Gregg Kellogg: Use @included instead of @graph if this is a problem.
PROPOSAL: No change to current behavior. Document issues in JSON-LD and YAML-LD
Gregg Kellogg: +1
Pierre-Antoine Champin: +1
Ted Thibodeau Jr.: +1
Benjamin Young: +1
David I. Lehn: +0
RESOLUTION: No change to current behavior. Document issues in JSON-LD and YAML-LD
Pierre-Antoine Champin: Looking at the issue, I realized that the Rust library for JSON-LD is not compliant. It does remove @graph using example input.
... We might be missing a test about this case. I haven't had a chance to check yet.
... I mostly copied the first JSON example which is just an array with an object using @context and @graph and nothing else.

Subtopic: issue w3c/json-ld-api#584

https://github.com/w3c/json-ld-api/issues/584 -> Issue 584 Unify document loading in Context Processing? (by helins) [spec:editorial] [ErratumRaised]
Gregg Kellogg: Perhaps a chance to DRY up the text.
Pierre-Antoine Champin: I'm hesitant to extract the common functionality, so maybe just go for consistency so as not to disrupt the flow of the document.

Subtopic: issue w3c/json-ld-api#605

Anatoly Scherbakov: The issue about JSON Serialization: https://github.com/w3c/json-ld-api/issues/605
https://github.com/w3c/json-ld-api/issues/605 -> Issue 605 It is not clear enough what "JSON Serialization" is (by anatoly-scherbakov) [spec:editorial] [ErratumRaised]
Gregg Kellogg: Perhaps extract the json serialization for responding to a content type request.
Anatoly Scherbakov: We could specify a "serialize()" function to do this, if it takes a content type.
... The API can describe when to serialize.
... I wanted to be sure that we agree that an expand function should return a datastructure, and not a serialization.
Pierre-Antoine Champin: I misunderstood what you said before, and agree that we should fix the API definitions.
Niklas Lindström: Also agree to fix, but "do less". :)
... I understand anatoly-scherbakov's concerns about how to define this, but also worry about what this could disrupt.

Topic: Next call

Gregg Kellogg: Next meeting in two weeks is a WG meeting.