doc tweaks and updates to examples