[Python-Dev] Playing with a new theme for the docs

Stephen J. Turnbull stephen at xemacs.org
Fri Mar 23 00:59:28 CET 2012


On Thu, Mar 22, 2012 at 11:56 PM, Greg Ewing
<greg.ewing at canterbury.ac.nz> wrote:
> Can we please get rid of the sidebar, or at least provide
> a way of turning it off? I don't think it's anywhere
> near useful enough to be worth the space it takes up.

+1.  It seems to mostly duplicate the headline next/previous
buttons already duplicated in the footer, it doesn't give you the
whole TOC, and the whole TOC already present in many nodes.

The "Search bar" is a standard feature of most headers (and
sometimes footers), and I like the "Report a Bug" link because
it confirms to the reader that Python developers actually care
what they (readers) think.  I guess there is enough room for both
of those in the header even after subtractiing the horizontal
space for the sidebar.

> A table of contents as a separate page is a lot more
> usable for me.

I agree, but with emphasis on the *for me* part.  I suspect this is
a personal preference.

> Also I agree about the grey text being suboptimal.

+1 for black text or a perceptibly darker grey.

> Deliberately throwing away contrast, especially for
> the main body text, is insane.

It does *look* nice, though.

Overall, very nice job, Georg!


More information about the Python-Dev mailing list