Update st2client README

Sync with the CLI section in the main document. Use reStructuredText instead of Markdown.