cleaning up examples and updating the readme to document what the examples are for