Update st2client README

Sync with the CLI section in the main document. Use reStructuredText instead of Markdown.
Merge pull request #808 from StackStorm/update-cli-docs

Update st2client README