documentation updates, small polish to examples