Well, I think code samples should not be in the documentation. The documentation should provide links to the code samples in, as you say, a place like the wiki. Code directly with the documentation is clutter. The current system, where they are by default hidden, is a good one.
- [pygame] monthly FAQ? Dave LeCompte (really)
- Re: [pygame] monthly FAQ? Ian Mallett
- Re: [pygame] monthly FAQ? René Dudfield
- Re: [pygame] monthly FAQ? Ian Mallett