Bitching about the documentation...

Paul Rubin http
Tue Dec 6 05:40:28 CET 2005


Steve Holden <steve at holdenweb.com> writes:
> Or, better still, by an accomplished writer who has access to the
> code's author. This was indeed my experience in writing the docs for
> previously undocumented modules. The author was happy to help me by
> answering questions, and this did make the docs better than they'd
> otherwise have been.

Yes, this can work pretty well for some modules, especially when
there's in-person contact rather than just email.  The total amount of
work done between the two people may be more than would be needed if
the coder just wrote the docs and got it over with.  But any way that
gets it done is fine.



More information about the Python-list mailing list