The KDL Document Language
kdl.dev
The KDL Document Language
1–10 of 64 posts
Re: The KDL Document Language
#2I really like the /- ("slashdash") comments. Seems like they did a lot of things right! I might use this in projects.
Re: The KDL Document Language
#3Nice doc, but I feel like it's confusing documents like XML/HTML and tree-structured data like JSON.
It seems like it would be annoying to write this directly, like how do you make a word bold or italic? How do you make a class of hyperlink that's a different color (e.g. internal links vs. external)? HTML is OK but not fun to write directly -- I'm not sure that KDL is an improvement. You would still want something like Markdown.
On the other hand it could be better for tables, which are awkward in HTML. But I'd like to see how that works.
In summary:
- XML/HTML: better when you have more text than data. Good for docs, awkward for tables.
- JSON: better when you have more data than text. Good for web API request and response, awkward for docs (e.g. do you want to write markdown or HTML inside double quotes?). OK for config files but awkward because it's a strict format.
Re: The KDL Document Language
#4Obligatory xkcd: https://xkcd.com/927/
Also yes, I'm aware the author states:
>Have you seen that one XKCD comic about standards?
>Yes. I have. Please stop linking me to it.
To which I say: You shouldn't have created a new standard if you didn't want to be linked to the xkcd. Any annoyance is self inflicted, and you've weaponized the internet against yourself.
Re: The KDL Document Language
#5Nice doc, but I feel like it's confusing documents like XML/HTML and tree-structured data like JSON. It seems like it would be annoying to write this directly, like how do you make a word bold or italic? How do you make a class of hyperlink that's a different color (e.g. internal links vs. external)? HTML is OK but not fun to write directly -- I'm not sure that KDL is an improvement. You would still want something li…
Right near the end:
> Finally, KDL is not a markup language.
Re: The KDL Document Language
#6Nice doc, but I feel like it's confusing documents like XML/HTML and tree-structured data like JSON. It seems like it would be annoying to write this directly, like how do you make a word bold or italic? How do you make a class of hyperlink that's a different color (e.g. internal links vs. external)? HTML is OK but not fun to write directly -- I'm not sure that KDL is an improvement. You would still want something li…
Here's an example of how a HTML page would be presented.
https://github.com/kdl-org/kdl/blob/main/examples/website.kd...
Re: The KDL Document Language
#7Obligatory xkcd: https://xkcd.com/927/ Also yes, I'm aware the author states: >Have you seen that one XKCD comic about standards? >Yes. I have. Please stop linking me to it. To which I say: You shouldn't have created a new standard if you didn't want to be linked to the xkcd. Any annoyance is self inflicted, and you've weaponized the internet against yourself.
This isn't a unifying standard, which is what the XKCD comic is about. It's not attempting to take other standards and develop the One To Rule Them All—you know, like the first panel of the comic describes—but rather building a different tool that's a better fit for some specific use-cases.
Honestly, if the internet had been around when the screwdriver was invented, the Hacker News commenters of the time would have been linking to XKCD 927 along with snide comments about how hammers and wrenches already exist.
Re: The KDL Document Language
#8Hi!
I'm the author of the Java KDL library, https://github.com/hkolbeck/kdl4j. I'm currently overwhelmed by other things and unable to do the work to get it up to the 1.0.0 spec. I'm looking for folks willing to help me. DM me on Twitter at the same name if you're interested.
Re: The KDL Document Language
#9Nice doc, but I feel like it's confusing documents like XML/HTML and tree-structured data like JSON. It seems like it would be annoying to write this directly, like how do you make a word bold or italic? How do you make a class of hyperlink that's a different color (e.g. internal links vs. external)? HTML is OK but not fun to write directly -- I'm not sure that KDL is an improvement. You would still want something li…
Here's an example of how a HTML page would be presented. https://github.com/kdl-org/kdl/blob/main/examples/website.kd...
It actually looks pretty similar to GraphQL but without parens around argument lists. I wonder whether the author looked at it as well (might be interesting to compare).
Re: The KDL Document Language
#10Earlier quoted context omitted.
Here's an example of how a HTML page would be presented. https://github.com/kdl-org/kdl/blob/main/examples/website.kd...
It actually looks pretty similar to GraphQL but without parens around argument lists. I wonder whether the author looked at it as well (might be interesting to compare).
Which reminds me, the doc doesn’t mention typeaheads. The ability to provide suggestions should be one of the considerations when designing a new syntax.