Python documentation too difficult for beginners

Ian ian.g.kelly at
Tue Nov 2 19:51:42 CET 2010

On Nov 2, 8:47 am, jk <sanjo... at> wrote:
> You're right in that the python docs in this case are less lines, but
> that's one of the problems. It doesn't mention anywhere the extra
> detail you've added regarding exceptions thrown. That's the kind of
> thing that probably comes through experience or some kind of
> convention which isn't obvious to beginners. Having things split into
> sections - parameters, return types, exceptions, etc - lets me find
> what I'm looking for quickly.

It doesn't mention it because those exceptions don't actually have
anything to do with the id() function.  They're just what happens any
time an unbound variable name is evaluated, in any context.  The exact
same thing could be said about any Python function in existence that
takes at least one argument.


More information about the Python-list mailing list