adds example and improves doc