search

kdl-org / kdl

the kdl document language specifications
https://kdl.dev
Other
1.1k stars 61 forks source link

KDL examples to go with KDL schema example(s) #251

Open micahsnyder opened 2 years ago

micahsnyder commented 2 years ago

The example schema at https://github.com/kdl-org/kdl/blob/main/examples/kdl-schema.kdl would be easier to grok if there were a corresponding kdl file or two that fits the schema. It could maybe go at the top of the schema in a comment block for easy reference.

It would be even better if we could add some markdown documentation with schema/kdl examples in pairs.

I'm only just starting to play with KDL so I'm not able to contribute this myself (yet).

boringcactus commented 2 years ago

That schema corresponds to the KDL Schema specification, so the document that fits that schema is itself.