updates some of the examples to be clearer