Do you feel bad because of the Python docs?

Mitya Sirenef msirenef at lightbird.net
Tue Feb 26 23:45:17 EST 2013


On 02/26/2013 10:09 PM, Mitya Sirenef wrote:
> (As a side note, I think it  would be better if sections in datetime were
 > in separate pages, it would be easier to google and the navbar on the
 > left side is very crowded and rather hard to read - often I find myself
 > missing stuff that's in there and ending up just scrolling down through
 > the document until I find what I need -- it might be better if section
 > numbers were not included there, font for keywords was not fixed width
 > font, and topics didn't wrap so much - in case of datetime, all of the
 > topics have enough horizontal space not to wrap and yet 3 out of 7 do 
wrap!)

In regard to Python doc topic menu readability -- compare to the django
topic menu:

https://docs.djangoproject.com/en/dev/topics/db/queries/

It's ridiculous how much more readable it is, at least to my eyes!

  -m


-- 
Lark's Tongue Guide to Python: http://lightbird.net/larks/




More information about the Python-list mailing list