Bitching about the documentation...

skip at pobox.com skip at pobox.com
Mon Dec 5 22:30:35 EST 2005


    Paul> For example, writing a good doc patch for urllib2 would mean
    Paul> checking RFC 2616(?) against the urllib2 code to see what parts of
    Paul> the RFC got implemented and what parts didn't.  It might also mean
    Paul> comparing urllib2 with other libraries like LWP (Perl) or whatever
    Paul> the equivalent is in Java.

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.

Skip



More information about the Python-list mailing list