OpenSource documentation problems

Steve Holden steve at holdenweb.com
Fri Sep 2 04:55:16 CEST 2005


Fredrik Lundh wrote:
> Rocco Moretti wrote:
> 
> 
>>Something a simple as allowing doc bugs to be submitted from a webform
>>w/o login would reduce the barrier to contribute. - Increasing the size
>>of the "About" text wouldn't hurt either. (To be honest, I've never
>>noticed that text before, and it never occurred to me look at the
>>"About" page for information on error reports.)
> 
> 
> the useredit approach I'm using over at the librarybook site works
> pretty well.  for example, if you go to
> 
>     http://effbot.org/librarybook/mailbox.htm
> 
> and click "suggest changes" at the bottom, you can edit the page
> source, preview the changes, and generate a patch when you're
> done, all without signing up or logging in.
> 
> (unfortunately, Python's documentation is written in LaTeX, using
> a rather advanced tool chain to get from sources to HTML, so the
> librarybook approach won't really work "out of the box")
> 
That's true, but (as I mentioned a few minutes ago in another post) the 
docs team will happily accept plain text of that's all the contributor 
can provide. It's *that* fact that needs to become more obvious.

regards
  Steve
-- 
Steve Holden       +44 150 684 7255  +1 800 494 3119
Holden Web LLC             http://www.holdenweb.com/




More information about the Python-list mailing list