updates per review comments; new examples