[Twisted-Python] Lore to Sphinx Conversion Progress Report

Kevin Horn kevin.horn at gmail.com
Wed Dec 2 16:03:39 MST 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
>
>
Marco,

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: </pipermail/twisted-python/attachments/20091202/cb0a2061/attachment.html>


More information about the Twisted-Python mailing list