On 12/16/2015 09:23 AM, Pradeep Gowda wrote:
On Wednesday, 16 December 2015 at 13:52:05 UTC, Andrei Alexandrescu wrote:
On 12/15/15 9:01 PM, deadalnix wrote:
On Wednesday, 16 December 2015 at 01:15:45 UTC, Andrei Also, ddoc
always appeared to me like a big NIH syndrome.
What would you have done instead?
While I like ddoc for inlined documentation, I believe that using a easy
to learn, and well supported (in IDEs, editors, github, familiar to
programmers coming from any other language background) format like
Markdown is the way to go.
I'm very partial to using pandoc (http://pandoc.org/) as a universal
processor for converting markdown to various output formats. Rust used
pandoc as their processor till they wrote their own toolchain. (writing
markdown parsers appears to be right of passage to some...).
Of course, there are multiple implementations of what "markdown", but
http://commonmark.org/ is a step in the right direction (created by the
author of Pandoc, with others).
I think Markdown postdates 2001. So at this point, would it be worth it
switching over to Markdown? -- Andrei
