Documentation suggestions
Fredrik Lundh
fredrik at pythonware.com
Tue Dec 6 12:39:07 EST 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)
</F>
More information about the Python-list
mailing list