improved docs and samples