add curl example and clarify language