finish first round of docs
make it a little more readable