[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