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

[Georg Brandl]

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