Enhanced doco in response to community feedback.
Merge branch 'master' of github.com:playframework/playframework