[Python-Dev] Playing with a new theme for the docs (original) (raw)

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