improve example and descriptions.