On Tuesday, 12 December 2017 at 06:55:45 UTC, Jonathan M Davis
wrote:
On Tuesday, December 05, 2017 20:11:33 Walter Bright via
Digitalmars-d wrote:
https://help.github.com/articles/basic-writing-and-formatting-syntax/
Anyone interested in picking up the flag?
(I know this has come up before, and I've been opposed to it,
but I've
changed my mind.)
I confess that looking over that page, I don't see much reason
to add any of it to ddoc. It all seems like stuff that we can
already trivially do in ddoc, and most (all?) of it is stuff
that already has built-in macros. What are we really trying to
gain here?
1) I avoid writing something like $(I foo) into a comment.
Because other people may actually read my source code and not
just read a generated documentation from a source code. So, I
would prefer writing *foo* or _foo_. After all that's the point
of markdown: Pure text _looks_ like intended and enables
html-generation at the same time.
2) If someone learns the D programming language, I think it would
be advantageous, if that person could just write down the already
known markdown grammar