Why I'm hesitating to switch to D

[Jacob Carlborg]

On 2011-06-29 15:12, James Fisher wrote:
> OK.  These are all good reasons to maintain code documentation in Ddoc
> -- i.e., the Phobos documentation.  Let's drop the argument over
> replacing the documentation format.  What I'm not convinced of is that
> Ddoc is has any advantage over a generic markup format when it comes to
> the homepage, associated pages (FAQ, acknowledgements, etc.), howtos, or
> even the language reference.  When I look over any of those documents --
> lex.dd
> <https://github.com/D-Programming-Language/d-programming-language.org/blob/master/lex.dd>
> to take a random example -- I don't see any semantics that can't be
> expressed even in something as simple as Markdown.  Forcing people to
> write their howtos in Ddoc is asking too much for no good reason.

I completely agree with this.

-- 
/Jacob Carlborg