doc: Updated pull request with suggested changes.

signed-off by: John Wilkins <john.wilkins@inktank.com>