Comment by joemi
4 days ago
Why rely on someone to intuit what you could just simply state explicitly? That sounds like you're just asking for trouble if someone doesn't think/intuit in exactly the same way that you do.
4 days ago
Why rely on someone to intuit what you could just simply state explicitly? That sounds like you're just asking for trouble if someone doesn't think/intuit in exactly the same way that you do.
Including the technical spec explicitly is still a good idea. Examples without a word of summary would just be strange!
It's merely that I think unstructured English is not a good language for communicating knowledge of how to use an API.