docs and example updates