tweaks to a couple examples and additional doc massaging