Why rely on someone to intuit what you could just simply state explicitly? That ... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		joemi 82 days ago \| parent \| context \| favorite \| on: Examples are the best documentation 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.

Paracompact 81 days ago [–]

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.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact