How to doc

[benlk]

This PR would merge Dave Ryan's past work on docs for this plugin. Before it merges:

• [ ] does this duplicate existing docs in our plugin?
• [ ] if not, link to these docs from the existing docs in the docs/ directory
• [ ] make any edits necessary