Improve docs on adding commands

* talk about waiting instead of async
* syntax highlighting
* typos