From ready2produce at yahoo.com  Sat May  2 01:47:08 2009
From: ready2produce at yahoo.com (David Butler)
Date: Fri, 1 May 2009 16:47:08 -0700 (PDT)
Subject: [PSF-Volunteers] Change Python documentation paradigm
Message-ID: <788829.18087.qm@web51809.mail.re2.yahoo.com>


I think that the ActivePython HTML documentation approach is inadequate,

I have a better strategy which I describe on my ning website.

I'm looking for an experienced Python programmer willing to take measures to remove existing Python tutorial gotchas.

As a start, I would like to email invite that person to the website.

The website's point: OpenOffice Writer is superior to HTML.

David Butler 



      

From steve at holdenweb.com  Sat May  2 02:40:16 2009
From: steve at holdenweb.com (Steve Holden)
Date: Fri, 01 May 2009 20:40:16 -0400
Subject: [PSF-Volunteers] Change Python documentation paradigm
In-Reply-To: <788829.18087.qm@web51809.mail.re2.yahoo.com>
References: <788829.18087.qm@web51809.mail.re2.yahoo.com>
Message-ID: <49FB9670.4040906@holdenweb.com>

David Butler wrote:
> I think that the ActivePython HTML documentation approach is inadequate,
> 
> I have a better strategy which I describe on my ning website.
> 
> I'm looking for an experienced Python programmer willing to take measures to remove existing Python tutorial gotchas.
> 
> As a start, I would like to email invite that person to the website.
> 
> The website's point: OpenOffice Writer is superior to HTML.
> 
OK, first of all the ActivePython distribution isn't open source, so I
hope that what you are talking about is actually the same tutorial
published in docs.python.org.

Open Office Writer may be superior in some ways to basic HTML, but you
have to consider the delivery mechanisms as well as the preparation
mechanism. You can read HTML with only a browser, and insert hypertext
links in the documents.

So, maybe a few more details before someone asks for an invitation?

regards
 Steve
-- 
Steve Holden           +1 571 484 6266   +1 800 494 3119
Holden Web LLC                 http://www.holdenweb.com/
Watch PyCon on video now!          http://pycon.blip.tv/