update documentation and examples to reflect recent code changes
update to reflect recent code changes.