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
probably kick this off using the github wiki, and if that breaks down we'll try something else.