OpenSource documentation problems
Fredrik Lundh
fredrik at pythonware.com
Thu Sep 1 11:09:27 EDT 2005
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")
</F>
More information about the Python-list
mailing list