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.
