>Actually, it would just move the "endless, petty discussions about what >minutiae are more important" into the docs. I don't see how that's an >improvement.
Because it highlights the issues you will be faced with when using the described functions. People will post about an issue they had with a function, and then they will post their solution. Instead of having to search all over google for an answer, the most relevant discussions will be right in the docs. As you read the user comments, you would be able to quickly tell whether a comment pertains to the issue you are having trouble with, and if the comment isn't relevant, you can skip the comment and look at the next comment. If you wanted, you could limit yourself to reading just the official python description of the function and be no worse off. >And most will simply be confused. Then it's likely someone will post something to clear up the confusion. -- http://mail.python.org/mailman/listinfo/python-list
