Path: csiph.com!usenet.pasdenom.info!gegeweb.org!de-l.enfer-du-nord.net!feeder1.enfer-du-nord.net!feeds.phibee-telecom.net!newsfeed.xs4all.nl!newsfeed2.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <msirenef@lightbird.net>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.005
X-Spam-Evidence: '*H*': 0.99; '*S*': 0.00; 'subject:Python': 0.05; 'width': 0.07; 'python': 0.09; 'python:': 0.09; 'django': 0.10; 'sections': 0.13; 'menu:': 0.16; 'navbar': 0.16; 'readable': 0.16; 'received:74.55.86': 0.16; 'received:74.55.86.74': 0.16; 'received:smtp.webfaction.com': 0.16; 'received:webfaction.com': 0.16; 'url:djangoproject': 0.16; 'wrote:': 0.17; 'url:dev': 0.17; 'doc': 0.22; 'least': 0.25; 'header:In-Reply-To:1': 0.25; 'header :User-Agent:1': 0.26; 'pages,': 0.27; 'separate': 0.27; 'topic': 0.27; '(as': 0.27; 'fixed': 0.28; 'horizontal': 0.29; 'wrap': 0.29; 'included': 0.29; 'topics': 0.30; 'stuff': 0.30; 'to:addr :python-list': 0.33; 'pm,': 0.35; 'subject:?': 0.35; 'there': 0.35; 'compare': 0.36; "didn't": 0.36; 'enough': 0.36; 'rather': 0.37; 'subject:: ': 0.38; 'easier': 0.38; 'url:docs': 0.38; 'there,': 0.38; 'url:en': 0.38; 'to:addr:python.org': 0.39; 'received:192': 0.39; 'space': 0.39; 'google': 0.39; 'received:192.168': 0.40; 'think': 0.40; 'side': 0.61; 'more': 0.63; 'subject:you': 0.88; 'crowded': 0.91
Date: Tue, 26 Feb 2013 23:45:17 -0500
From: Mitya Sirenef <msirenef@lightbird.net>
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130106 Thunderbird/17.0.2
MIME-Version: 1.0
To: python-list@python.org
Subject: Re: Do you feel bad because of the Python docs?
References: <512cb0a0$0$30001$c3e8da3$5496439d@news.astraweb.com> <512D05F3.5070901@lightbird.net> <kgjpc9$csp$1@ger.gmane.org> <512D78D3.1020201@lightbird.net>
In-Reply-To: <512D78D3.1020201@lightbird.net>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list/>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.2593.1361940322.2939.python-list@python.org>
Lines: 24
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1361940322 news.xs4all.nl 6958 [2001:888:2000:d::a6]:60368
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:40030

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/