Closed mstade closed 10 years ago
Pandoc Markdown and ReST Compared
Easily digested and useful, albeit biased, commentary on Pandoc Markdown vs. ReST.
Consider moving this to a file within the repo.
There's some good stuff in YAML that might be worth looking at for inspiration. It's a well written spec with a clear structure. Particularly, I think YAML's view on data structures (that all structures it wants to model can be modelled using maps, lists or scalars) overlaps with PHML. The obvious difference being that in addition to these primitives, PHML adds hypermedia, meaning PHML can actually describe much more complex structures.
There's some obvious overlaps in syntax (lists and maps certainly) and perhaps the rules in YAML can provide useful insight in to possible gotcha's with less strict syntax. As well, it can probably provide some inspiration for useful additional primitives (such as inline list syntax, as opposed to block lists.)
(Actually, looks like YAML does support some hypermedia constructs.)
It's important to consider prior art in this process, not just for inspiration but also in order to learn from the successes for failures of other formats. Let this issue be a collection of links and discussions for future reference.