[0cf8612b2e1e]

Markdown is too anemic for documentation without extensions. Sure, you can make do, but I would rather wet standardized on something more powerful.

[SpaghettiCthulu]

I agree. We need a standardized format with support for both structured (classes, methods, etc.) and unstructured (language overview) documentation..

[djbusby]

I'm still loving asciidoc. Loads of extensions too so I can have PlantUML and Mermaid stuff too