Andrei's Google Talk

Nick Sabalausky a at a.a
Fri Aug 6 22:19:03 PDT 2010


"Jesse Phillips" <jessekphillips+D at gmail.com> wrote in message 
news:i3hr7p$1s1$1 at 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.




More information about the Digitalmars-d mailing list