I agree that more progress is needed on the Python documentation front. For example if you look at the "codecs" module documentation there is no hint of what a codec is anywhere that I can see. Also the distinction between an "encoder" and a "decoder" is not explained. Even though I've used it many times and understand it, I still find myself using the interactive interpreter to make sure I'm sending the bytes in the right direction...
Perhaps some faqwiz/wiki-like tool to allow the broader community to propose documentation enhancements would be useful? -- Aaron Watters === "I know what it's like to put food on my family." G.W.Bush -- http://mail.python.org/mailman/listinfo/python-list