Those are all good points, and we know the layout needs to improve.
I would add though that once you've gone through the basics, you find yourself primarily living in the Type Reference, which is arranged alphabetically.
http://docs.puppetlabs.com/references/stable/type.html
Always happy to get bug reports, feature requests and feedback on the docs...