On Sat, 7 Aug 2010 01:19:03 -0400, Nick Sabalausky <[email protected]> wrote: > > "Jesse Phillips" <[email protected]> wrote in message > news:[email protected]... > > 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 ;)
