[Twisted-Python] Lore to Sphinx Conversion Progress Report

Kevin Horn kevin.horn at gmail.com
Wed Dec 2 18:03:39 EST 2009

On Mon, Nov 30, 2009 at 4:39 PM, Marco Giusti <marco.giusti at gmail.com>wrote:

> On Mon, Nov 30, 2009 at 03:05:30PM -0600, Kevin Horn wrote:
> > [...]
> > Thanks for "listening"!
> some notices about what i get[1]. mainly i'd like if you could make the
> documentation more readable when the browser's window is not really big.
> usually i do not use the browser with the window maximized so will be
> really helpful if you can check the following points:
> * in the navigation bar "twisted web documentation" is repeated twice
> and is breaked in two lines.
> * the table of contents steals a lot of vertical space while it is
> visible only at the top of the page. in this circumstances i prefer "the
> lore way", ie. showing the table of contents in the normal content flow
> at the top and not in a side column.
> * again the left blue column steal vertical space an maybe can be
> reduced.
> * would be great if the layout will fit in the page width: as you can
> see the index link is half hidden.
> obiviusly with a bigger window all the aboves are not more valid and all
> looks pretty.
> ciao
> m.
> [1] http://img44.imageshack.us/img44/1953/sphinx.png

Thanks for the feedback.  I really haven't worked at all on
formatting/theming the docs as of yet (what you see is just a theme included
with Sphinx), but I will certainly keep your comments in mind when I get to
that point.

Kevin Horn
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://twistedmatrix.com/pipermail/twisted-python/attachments/20091202/cb0a2061/attachment.htm 

More information about the Twisted-Python mailing list