Documentation suggestions

Fredrik Lundh fredrik at
Tue Dec 6 18:39:07 CET 2005

Ian Bicking wrote:

> > There's another struggle within the LibRef: is it a reference or a
> > tutorial?  Does it list methods in alphabetical order so you can look
> > them up, or does it list them in a pedagogically useful order?  I
> > think it has to be a reference; if each section were to be a tutorial,
> > the manual would be huge.  Here I think the solution is to encourage
> > separate tutorials and HOWTOs, and link to them from the LibRef.
> We don't have a clear place to put that material.  People's personal
> pages leave the potential for material disappearing

so ?  this "if we don't own it, we won't even pretend it exists" attitude
of the PSF is beginning to get a bit boring.

(the standard library suffers from the same problem)


More information about the Python-list mailing list