"Justin Spahr-Summers" <justin.spahrsumm...@gmail.com> wrote in message news:mpg.26c91a1af538b882989...@news.digitalmars.com... > On Sat, 7 Aug 2010 01:19:03 -0400, Nick Sabalausky <a...@a.a> wrote: >> >> "Jesse Phillips" <jessekphillip...@gmail.com> wrote in message >> news:i3hr7p$1s...@digitalmars.com... >> > Steven Schveighoffer Wrote: >> > >> >> I wouldn't mind the current docs, but I'd like to have some document >> >> to >> >> know what tags are defined and what they mean (like a ddocdoc), and >> >> how >> >> to >> >> define new tags. Maybe this already exists? >> > >> > My two comments are, shouldn't paragraphs be handled with a blank line? >> >> YES. >> >> And along those exact lines, may I say I'm a big fan of the Natural Docs >> approach. IMO, comments should be [*easily*] readable *before* being run >> through a doc generator, not just after. Of course, in that regard (not >> to >> mention writeability) DDoc beats the snot out of C#'s horrid XML comments >> (I've never understood MS's enormous obsession with XML), but DDoc still >> has >> that same fundamental problem. > > Just in case you haven't seen this page before: > http://www.charlespetzold.com/etc/CSAML.html > > ;)
That's great! I hadn't seen that before. Love it. I did experience a couple seconds of sheer horror before I realized it was a joke :)
