On Thursday, 16 May 2013 at 20:55:18 UTC, Adam D. Ruppe wrote:
I think if you're using a lot of macros, ddoc starts to lose
value because then it is harder to read in the code. The
plainer the text, the better, IMO.
I use ddoc macros only on the individual ($important word) here
and there and sometimes little ($lists, of, simple, stuff).
I think you're right, Adam. A standard 80-character line of code
gets swallowed up pretty quickly in tags. Macros are certainly
more concise but I've noticed that their main (ab)use is as HTML
shorthand. I'm guilty of much the same: using macros to cut down
on the amount of copy-and-pasting I have to do when I want to
make a bunch of similar XML tags real quick.
A corollary to this question is how much opposition I'd face if I
were to rewrite the DLangSpec source files into a different
markup. A corollary to the corollary is which standard would be
easiest to write, read, understand and maintain?
