update documentation and examples to reflect recent code changes