more examples and clean up of some of the api
added contrib instructions