change method signature, add usage example