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

Martin Meredith report at bugs.python.org
Tue Dec 2 15:38:27 CET 2008

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:-


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>

More information about the New-bugs-announce mailing list