Hello Justin Spahr-Summers,
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
;)
I wonder how long that took to write. Just the typing must have taken some
time but if you factor in the time take to recover from the laughter induce
injuries it may have taken weeks!
--
... <IXOYE><
