removing bin/obj, implementing fail handling, adding example for simple and complex cases
fixing examples and references