[DOC-SIG] Tutorial

David Ascher da@maigret.cog.brown.edu
Wed, 11 Jun 1997 16:22:05 -0400 (EDT)

On Wed, 11 Jun 1997, Gerco Ballintijn wrote:

> I was wondering what the plans were concerning the tutorial.
> Will it contain a new chapter 'New in Release 1.5' or is
> there a rework coming along? I think an up to date tutorial
> is beneficial to new Python programmers. The tutorial is
> less important to seasoned veteran programmers, but to new
> programmers it can be an important stepping stone. I found
> it a usefull introduction to the source code and the examples
> around. I would be willing to contribute in this area.

As Guido is away, I'll answer w/ my understanding.  The tutorial is badly
in need of a complete overhaul.  It's on Guido's TODO list, but as we all
know, that's a big list.  I think that the original tutorial is excellent
-- it is the single thing which decided me to *really* try Python, and I'm
glad I did.  

If you are willing to try an overhaul, I'd say go right ahead -- but be
aware that Guido (et al.) will probably want to be quite tough editors
with whatever you come up with -- rightly so, I think, since the document
has high visibility.  

But this is not at all meant to discourage an effort -- anyone who
volunteers to help with any aspect of the doc will be encouraged, and
anyone who delivers good doc will be heralded high and wide!  (maybe we
should have a "Python contributor of the month" award =).


DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org