News for hackers. Stuff that matters.
Re:DevDocs by 0cf8612b2e1e on Friday January 12, 2024 @05:36PM (#38975106)
Markdown is too anemic for documentation without extensions. Sure, you can make do, but I would rather wet standardized on something more powerful.
Re:DevDocs by djbusby on Friday January 12, 2024 @09:19PM (#38976733)
I'm still loving asciidoc. Loads of extensions too so I can have PlantUML and Mermaid stuff too
Re:DevDocs by SpaghettiCthulu on Friday January 12, 2024 @10:11PM (#38976987)
I agree. We need a standardized format with support for both structured (classes, methods, etc.) and unstructured (language overview) documentation..