update documentation and examples to reflect latest changes