Skip to content

YAML-LD proposal #873

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Conversation

anatoly-scherbakov
Copy link
Contributor

Fixes #871

Copy link
Contributor

@TallTed TallTed left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Small changes

@BigBlueHat
Copy link
Member

@anatoly-scherbakov I like where this is headed! I think we may need a conversation (here or on a call) about how to explain YAML-LD and CBOR-LD to the wider developer community. I thing "spin-offs" is a good way to start, but it does beg the question of what are these things...and what is this ecosystem?

Should developers expect JSON-LD to work like a "hub" format? or could one expect to go from CBOR-LD to YAML-LD (and vice versa)?

We don't have those answers yet. 😉 And I don't want to delay getting more content on the site, so I'm generally 👍 to what you're proposing here. Just noting we may need to rework it again soon to explain all the things as we grow in our own understanding of them. 😸

@BigBlueHat BigBlueHat requested review from gkellogg and davidlehn May 13, 2025 13:03
Copy link
Member

@BigBlueHat BigBlueHat left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is off to a great start! I think we may want to consider having top-level folders for /yaml-ld/ and /cbor-ld/ rather than putting them in the Learn section...but I'm on the fence about that.

Overall, it's great to see this content showing up, and I think this is a good way to start.

Happy to help you rework it if/as we hear from others about where best to put this content longer term.

</div>

<div class="row">
<!--div class="span3">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Feel free to just remove stuff rather than comment it out.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thought maybe there are tools that I missed and we could quickly get them back :) But generally yes I agree, I'll see into doing a cleanup in one of the follow up PRs.

@anatoly-scherbakov
Copy link
Contributor Author

how to explain YAML-LD and CBOR-LD to the wider developer community. I thing "spin-offs" is a good way to start, but it does beg the question of what are these things...and what is this ecosystem?

I thought of introducing a notion of *-LD, Asterisk-LD. Anything-LD, basically. Which means that basically any data format can be interpreted in a semantic way.

Having said that,

Should developers expect JSON-LD to work like a "hub" format? or could one expect to go from CBOR-LD to YAML-LD (and vice versa)?

…I think conversions among all the possible *-LD formats would very quickly become very astronomical in complexity if we want to add more such formats, so I suppose JSON as a middle ground among them all can be a handy thing.

Just noting we may need to rework it again soon to explain all the things as we grow in our own understanding of them.

Most definitely, the only constant is change. Incidentally that rhymes with what I've been thinking lately about what the purpose of LD is: I think it might be formulated as "accelerate change to knowledge while preserving its consistency".

I think we may want to consider having top-level folders for /yaml-ld/ and /cbor-ld/ rather than putting them in the Learn section...but I'm on the fence about that.

I suppose we can do so when we get more materials to publish maybe. Like, I am researching applications of YAML-LD for Nanopublications. We will need use cases and usage examples to lure people into using our technology so as we can be proud of ourselves that someone uses our stuff.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

YAML-LD tools
3 participants