From: Tom v. S. <tv...@et...> - 2003-03-30 19:45:32
|
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 reserva= tions > > > about it though: > > > (1) I haven't seen how the styles look in a graphical browser or prin= tout, > > > (2) Twisted Lore currently depends on a homegrown XML parser in Twist= ed, > > > which I'm reluctant to depend on. > >=20 > > Any more thoughts on this now that PyCon is done with? >=20 > 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 |