updating docs, gists, cli examples, etc.