Thanks for the note, Peter; I'll have a look at the Wiki tomorrow. In fact, most of the docs there are now out-of-date.
We're currently gunning to lock down the API into a backwards-compatible state in 1.0.0-beta-1. From there, we'll be shifting focus into documentation and other promotions before going GA.
Also: if you'd like to beat me to the punch and change up any docs yourself, we've adopted the Wiki format for just that reason. Anyone can contribute.