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