De-folksify the doc a little bit and clarify a few things.