One thing that really took me a long time to figure out was that using python on Windows XP is something different than using it on a mac or on linux. Some things just don#t work or at least work slighlty different. Maybe you could ad a more explicit warning about that.

Example: http://stackoverflow.com/questions/3391998/pydoc-is-not-work...