Make parameter doc RDoc compatible

The patch fixes the parameter documentation in
api, cert, compute and client to conform with
the style guide and support autogenerating
paramter documentation.

Change-Id: I94c6807a18be5eb27697eaa060a0e885a7d44cbe