Python docs disappointing

[Mark Lawrence]

r wrote:
> On Jul 31, 4:53 pm, Mark Lawrence <breamore... at yahoo.co.uk> wrote:
>> r wrote:
>>> On Jul 31, 4:16 pm, Carl Banks <pavlovevide... at gmail.com> wrote:
>>>> On Jul 31, 1:10 pm, kj <no.em... at please.post> wrote:
>>>>> I'm pretty new to Python, and I like a lot overall, but I find the
>>>>> documentation for Python rather poor, overall.
>>>>> I'm sure that Python experts don't have this problem: they have
>>>>> internalized some good ways to access the documentation, are
>>>>> productive with it, and therefore have lost the ability to see why
>>>>> the Python documentations is deficient for beginners.
>>>> That may be so, but I do remember when I was a beginner myself and I
>>>> had no issue with the documentation.
>>> have you tried the new docs (>= 2.6) The interface has changed
>>> drastically as to render itself completely useless. The old docs (<=
>>> 2.5) --the ones i learned from-- where flawless.
>>> @ Mark Lawrence
>>> Have you clicked any of those links? try the "Tutorial start here" and
>>> then try to find a menu of sorts. It seems you have to click "next" to
>>> navigate. Thats pretty counter intuitive if you need to get to page
>>> 589!! Upon clicking the tutorial link in the OLD DOCS, you where
>>> presented with a nice menu for concise navigation.
>> Yes.  Works perfectly as evidenced by the fact that this evening I've
>> checked data on the cProfile, pstats and array modules.
>>
>> --
>> Kindest regards.
>>
>> Mark Lawrence.
> 
> Hold the phone... You checked data on modules using the "Tutorial
> Start Here" link? Would not the "Global Module Index" be more, shall
> we say, "informative"?

You asked "Have you clicked any of those links?".  I answered yes since 
they all work.  I usually navigate to module data via the index tab as I 
find this the easiest way.  I'm sure other people prefer the global 
module index.  Six of one, half a dozen of the other?

-- 
Kindest regards.

Mark Lawrence.