Re: Documentation suggestions


Ian> I think it would be very useful if there was reference (not just
Ian> tutorial) documentation for all the syntax, special semantics like
Ian> magic methods, and all the functions and objects in builtins.

It's pretty common to have a User's Guide as well as a Reference Manual for
many applications. Python has always lacked a User's Guide.

I find it hard to imagine any one person having the time to simply sit down
and bat out such a tome though. I'm partial to using wikis as collaborative
environments. (They more readily admit a group of people to the process
without a formal registration process as would doing the whole thing via
Python's svn repository.) Creating a UsersGuide section of the Python wiki
with reST as the markup might be a good place to work on such a beast with
the goal that it would be a stepping stone to a more standalone document.

Skip
.

Relevant Pages

  • Re: Robin Cook: Adulterer
    ... >>> Ian ... > I saw that I was very careful to try and spell things correctly by using ... Dictionaries are reference tools to aid us in our ability to communicate. ...
    (soc.religion.quaker)
  • Re: AxtiveX EXE Is this Possible
    ... > reference that talks about threads and processes Ian. ... > ActiveX EXE instance ... >> So all I had to do is reference the ActiveX EXE form my VB Controller ...
    (microsoft.public.vb.enterprise)
  • Re: AxtiveX EXE Is this Possible
    ... > reference that talks about threads and processes Ian. ... > ActiveX EXE instance ... >> So all I had to do is reference the ActiveX EXE form my VB Controller ...
    (microsoft.public.vb.general.discussion)
  • Re: AxtiveX EXE Is this Possible
    ... > reference that talks about threads and processes Ian. ... > ActiveX EXE instance ... >> So all I had to do is reference the ActiveX EXE form my VB Controller ...
    (microsoft.public.vb.database)
  • Re: AxtiveX EXE Is this Possible
    ... > reference that talks about threads and processes Ian. ... > ActiveX EXE instance ... >> So all I had to do is reference the ActiveX EXE form my VB Controller ...
    (microsoft.public.vb.com)