On Sun, 2003-03-30 at 12:18, Ian Bicking wrote:
> On Sun, 2003-03-30 at 10:09, Tom von Schwerdtner wrote:
> > We could also
> > > consider it for Webware at some future date.  I have a couple reservations
> > > about it though:
> > > (1) I haven't seen how the styles look in a graphical browser or printout,
> > > (2) Twisted Lore currently depends on a homegrown XML parser in Twisted,
> > > which I'm reluctant to depend on.
> > 
> > Any more thoughts on this now that PyCon is done with?
> 
> I can't speak for Mike, but I really don't like HTML markup in
> docstrings.  I like writing reST, which isn't perfect, but is easy to
> write.  I think the ease of writing is more important than the output,
> for the most part, because complete documentation is more important than
> pretty documentation ;)

I agree.  reST is also alot more readable when browsing source...

-Tom

Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to