[New-bugs-announce] [issue4488] Python Documentation not Newb Friendly

[Martin Meredith]

New submission from Martin Meredith <mez at ubuntu.com>:

I'm a new python user (developing in python) and I recently had a
discussion with someone that my main issue with python is finding where
the functions are that I need to use.

An example (probably not the best) - I need to split a filename so that
I can have the extension and the rest of the filename seperate. Fine.. I
google, and I get the following page:-

http://www.python.org/doc/2.5.2/lib/os-path.html

Now, that lists the function splitext - which is what I need - but it's
not clear on the page where that function is located (os.path) 

I think that this should be made clearer somehow - as it seems to me
that you have to go through about 3 pages trying to work out where it is
(or work it out from the URL) - which isn't very intuitive, espescially
for a new user, who doesn't actually know where all the functions exist.

----------
assignee: georg.brandl
components: Documentation
messages: 76747
nosy: georg.brandl, mez
severity: normal
status: open
title: Python Documentation not Newb Friendly
type: feature request

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue4488>
_______________________________________