doc: Added comments from #6682.

fixes: #6682

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