I'm surprised to see this particular criticism applied across the board – Puppet's documentation is one of my favorite things about it.
The weakest part has always finding reference documentation — that is, things like this [1]. Everything is a bit buried and scattered. At least they finally have a complete list of configuration settings [2] now, which used to be a huge pain.