Improve documentation.

[rzeigler]

Current documentation is a rough draft. Add examples and more description. Also, typedoc -> markdown produces unimpressive output so investigate other mechanisms.

[rzeigler]

There always going to be more to do, but the documentation now lives in the github pages and isn't completely trash.