Update documentation.

Update documenation with notes on how to apply the plugin, the features it contains, and the general future direction.

@sgoings and @stormbeta - let me know what you think!
Nitpick: Block indentation is off in the example script.