improved documentation with a usage example