doc: Clean up syntax.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
doc: Clean up syntax to suppress warnings.

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