Ezio Melotti <ezio.melo...@gmail.com> added the comment: There are usually two cases that lead me to check the code: 1) The documentation is incomplete, not clear, missing, or plain wrong; 2) I want to check how something is implemented, mostly just out of curiosity;
Regarding the first case, in theory the docs should be informative and correct enough to not require you to go and check the code. If they aren't you can report issues and we can improve it. The second case applies to pretty much any module. Linking to the code might also expose some internal details that should be just ignored by the user. The code in some modules is also pretty old and might be a "bad" example (because it doesn't use modern conventions). Some of the modules you listed are actually packages, so that would require to link to several files. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue13437> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
