improve example and address discussion