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
