Like other users have mentioned, it seems the documentation is more for people familiar with Play. It is just small things here and there, small pertinent steps which make things work etc. It is hard to for an experienced person to document processes and actions they have performed hundreds of times, steps get missed. Plus it would be great if the Play documentation added a “User contributed Notes” section. This was always my absolute most favorite part of the PHP language. The fact that users can contribute as they make discoveries, really, really adds to the clarity of the documentation by a long shot. Look at the User Contributed Notes section.
Notice how users have added their notes. If you look throughout the docs you will notice users even note which versions of PHP their notes pertain too, when it is something affected by a major change. Play documentation gives you a link to some forum, where you then must search for anything you can find related to your issue. Having a “User Contributed Notes” section would greatly improve the documentation, especially for new users. Plus it’s not like there are millions and millions of people learning/using Play Or Scala, so this feature is less likely to be abused. It is nice to have info about the source right at the source.
So if there is any improvement that I think would make the most difference for Play, it would be adding a “User Contributed Notes” Section. Other than that I actually print some of the documentation and keep it in a 3 ring binder and take notes on notebook paper.