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).