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

Georg Brandl g.brandl at gmx.net
Thu Mar 22 07:48:44 CET 2012

On 21.03.2012 20:39, Guido van Rossum wrote:

Guido, you encouraged us to use science, but only after describing my science-based maximum line-length suggestion as "coddling," then said we should let Georg get on with it, but only after reiterating your personal favorite tweak (which I happen to agree with). I have a fair number of strong usability gripes about current (and past :-) design trends, but I know I can't design a decent looking website myself if my life depended on it.

There's no way a committee (which this thread effectively is) will come up with a good design. Everyone will dislike something about it. I think it would be interesting to use the power of the web to provide docs whose style could be adjusted a few ways to make people happy, but that is probably more than anyone is willing to volunteer for, I know I can't step up to do it. I think it's fine to have a bunch of folks submit their pet peeves (and argue them to the death :-) to the design czar and then let the czar (i.e. Georg) decide. Personally, I think two Python projects that have focused on docs and done a good job of it are Django and readthedocs.org. Perhaps we could follow their lead? I think they are actually more trend-followers,and they seem to make a bunch of the mistakes I've fulminated against here. But again, I'll leave it to Georg.

Thanks for the vote of confidence. I'll know what to consider for the next iteration thanks to the lively participation here :)

Georg

More information about the Python-Dev mailing list