Good point!
This way also we can see documentation as it is being written, so there it won't be frustrating to keep hearing that documentation is coming "any month now" (or any year for that matter - because seems that documentation for 2011 rOSes will be coming in 2012). Not to worry, as long as the section is marked as "beta", there will be understanding some API may change.