...but it would help if that feedback was a little less general and a little more comprehensive.

From a project standpoint, we have tried to make it clear that the Dojo Core and Dijit require full documentation, but DojoX does not; each "sub-namespace" in DojoX is really considered either a separate project, or a collection of related objects. Each directory contains a README file which will tell you the status of that "project"--and the status includes things such as proper documentation, unit test availability, etc. You can read how we define such statuses here:

http://dojotoolkit.org/book/dojo-book-0-9/part-5-dojox-extensions-dojo-0

WRT to the Grid (your example), odds are the reason why it is not well-documented at this point is because it is currently undergoing some major revisions. It *should* be well-documented by the time we release 1.2 but bear in mind that the documentation will probably focus on the new revision/versions, while the older (i.e. current) revision will probably remain in the state that it is in.