OpenSource documentation problems

Bryan Olson fakeaddress at nowhere.org
Tue Aug 30 03:32:09 EDT 2005


Adriaan Renting wrote:
[...]

 > I do agree that a lot of OSS projects seem to lack somewhat in
 > the documentation department, compared to a lot of commercial
 > software. I would give the man page of gcc as an example, it's
 > just one 6600 line blurb.

I don't see any need to look beyond Python for a good example of
poor documentation.  Are there serious Python programmers who
don't constantly struggle with errors and omissions in the doc?

I don't mind the 6600 line blurb form, just so long as the info
is there and is correct.


-- 
--Bryan



More information about the Python-list mailing list