Update docs

/CC @markgoodyear

I'll try splitting up most stuff from the other PR to make the process easier and faster to review.