Project Needs Documentation

probably kick this off using the github wiki, and if that breaks down we'll try something else.

> I would do a high level summary of the functionality so people have an
> idea what can be accomplished and then drill down into specific use
> cases. You've already covered the main use case in the readme so
> visibility of the hidden features would be helpful.
>  -lacota
