We're not some nameless corporation, and we (the engineers) do monitor these forums.
Like any other development operation, trade offs have to be made. In this case, we chose to get it in the market before all the docs were completely ready - in the interest of consumers being able to get started.
There is a major documentation upgrade incoming to address these concerns.