Marcus von Appen wrote:
Rene had some ideas (and plans, I think) to link the online docs together with the code examples, so users can directly see the usage of a method or another. Futher plans on the roadmap (http://www.pygame.org/wiki/todo) are to have an overall improvement of the comments and documentation.
Pygame comes with a handful of good examples. These are not usually found in the binary Windows package.
These small examples are far from showing the complete library.