initial draft of some documentation and examples.
added crude case generator for testing.