[Twisted-Python] Re: Lore vs. latex2html: Fight to the Finish

[François Pinard]

[Moshe Zadka]

> Dear Twisted developers,

I am not a developer, so I'm not sure if I may reply! :-)

> However, beyond that, I am interested to know which looks better:

> latex2html: http://www.ibiblio.org/obp/thinkCSpy/chap01.htm
> Lore: http://twistedmatrix.com/users/moshez/loreprop/
> (The Lore is using the Twisted documentation stylesheet.)

For my own taste, the first (latex2html) is a bit more legible, because it
has less distracting boxes, and the diagrams are more neat.  The navigation
bars at the beginning and the end give a bit of decoration, outside the
text, which is OK.  We should stay aware that "good looking" is only of
secondary value for documentation, legibility always goes before art.

> Any comments would be nice.  Comments which come with a patch to the
> stylesheet will be doubly appreciated.

By saying so, you reveal a prejudice towards the second (Lore).  :-)

-- 
François Pinard   http://www.iro.umontreal.ca/~pinard