Review comments.

@cableman Generally things look good. Most of my questions are regarding documentation.