update documentation and samples