adrdox vs markdown vs ddoc

Adam D. Ruppe destructionator at gmail.com
Thu Feb 1 17:33:21 UTC 2018


On Thursday, 1 February 2018 at 06:18:52 UTC, Seb wrote:
> To be fair, I feel with you and all the tables I have created 
> are formatted as good as DDoc allows, e.g.

Yeah, that's not bad, really. I think that's actually 
significantly better than the Markdown table syntax - adding a 
new function or category there is pretty easy and it is legible 
enough in the source.

> Same here.
> We recently added this to the DStyle:

Yeah, I saw. Actually, I saw a debate over /** */ vs /++ +/ too, 
and I'm pretty firmly on the /++ +/ side of it. Almost every time 
I write docs and do /** or even ///, I regret it because I want 
to change it to /++ later anyway so I can have commented code 
samples in the docs.

> I'm not a fan of Ddoc by any means, but that has been fixed in 
> Ddoc does this too now: https://run.dlang.io/is/75Z55o

Well, the url recognition is nice, but my main point there was 
actually that xrefs ideally aren't urls at all for a few reasons.

But still, it is better than nothing, no doubt.


More information about the Digitalmars-d mailing list