Bitching about the documentation...

Paul Rubin http
Mon Dec 5 22:39:35 EST 2005


skip at pobox.com writes:
> Sounds like a subject matter expert is needed here, not a garden variety
> tech writer or Python programmer.  Documentation of esoteric stuff requires,
> well, esoteric knowledge.

Yes, that's what I mean; coding a library module for an esoteric
function requires that same esoteric knowledge, and those are the
modules for which the docs need the most help.  So the person coding
the library module is the logical person to write the doc.  The doc
writing task can't in general be handed off to some random programmer
or writer.  It should be written by the same person who wrote the code.



More information about the Python-list mailing list