On 12/30/14 3:57 PM, ketmar via Digitalmars-d wrote:
On Tue, 30 Dec 2014 13:18:05 +0000
Russel Winder via Digitalmars-d <digitalmars-d@puremagic.com> wrote:
Markdown is inadequate for more than single page HTML
which is exactly what API reference documentation is! a list of
functions with explanations, some samples and a brief overview. this is
why markdown-like language is a good choice. stop writing Charles
Dickens' novels in source code, please! ;-)
Yes, exactly. If you need to add special HTML beyond what Markdown
offers you, then you are doing it wrong.
My question is: why D docs need more that the basics?
