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.
> I would add though that once you've gone through the basics, you find yourself primarily living in the Type Reference
Yes, that's were I ended up. I'm way beyond that level now, but I sometimes have to look something up in the docs, and always have to hunt down the URL to that particularly page.
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...
http://projects.puppetlabs.com/projects/puppet-docs