Source is great documentation by itself I agree. But when I started to go through source, I can see a couple of functions with no docstrings, there may be more like so. And for a total newbie to source, just be there to troubleshoot something it'll be hard. Because there's no docstrings he must go through the code with no knowledge of what it does and may be he has to jump into another functions and/or modules to get fuller understanding.
So, there's a great need to properly comment the source wherever necessary first.
