Re: Documentation suggestions

In article <mailman.1715.1133886680.18701.python-list@xxxxxxxxxx>,
A.M. Kuchling <amk@xxxxxx> 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.

Here's a question that kind of gets to the heart of a lot of the
problem: where does ``print`` get documented? If we can come up with a
good process for answering that question, we can probably fix a lot of
other problems. (Note emphasis on the word "process".)
--
Aahz (aahz@xxxxxxxxxxxxxxx) <*> http://www.pythoncraft.com/

"Don't listen to schmucks on USENET when making legal decisions. Hire
yourself a competent schmuck." --USENET schmuck (aka Robert Kern)
.

Relevant Pages

  • Re: Documentation suggestions
    ... Does it list methods in alphabetical order so you can look ... > think it has to be a reference; if each section were to be a tutorial, ... > separate tutorials and HOWTOs, and link to them from the LibRef. ...
    (comp.lang.python)
  • Re: Documentation suggestions
    ... Does it list methods in alphabetical order so you can look ... >> think it has to be a reference; if each section were to be a tutorial, ... >> separate tutorials and HOWTOs, and link to them from the LibRef. ...
    (comp.lang.python)
  • Re: Documentation suggestions
    ... Does it list methods in alphabetical order so you can look ... >>> separate tutorials and HOWTOs, and link to them from the LibRef. ... there's a lot of sources like the Python Cookbook, ...
    (comp.lang.python)
  • Documentation suggestions
    ... There are endless minor bugs in the library reference, ... separate tutorials and HOWTOs, and link to them from the LibRef. ... the guide is trying to be very formal; ... Perhaps we need a friendlier counterpart to the RefGuide, ...
    (comp.lang.python)
  • Re: Web service
    ... > how to add a web reference when there is a proxy ?? ... > "Karl Seguin" wrote: ... >> MY ASP.Net tutorials ... >>> in a datagrid on a website. ...
    (microsoft.public.dotnet.framework.aspnet)