I just do not understand why documentation continues to be a problem. There are ... | Hacker News

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

		jroseattle on Jan 10, 2012 \| parent \| context \| favorite \| on: Twitter’s poor API documentation practices I just do not understand why documentation continues to be a problem. There are plenty of API-as-platform models going around, and there will be more in the future. We are developers creating a product (an API) for other developers. We know what other developers are going to want to understand and the details they're going to need when implementing against an API. It should be crystal clear what information needs to be provided.

bentlegen on Jan 10, 2012 [–]

I look forward to seeing your perfectly-documented API product.

jroseattle on Jan 10, 2012 | [–]

Why strive for quality, eh?

Maybe we should just pat Twitter, Facebook, etc. on the back for what they provide and say "hey guys, appreciate the almost-accurate info."

Consider applying for YC's Summer 2026 batch! Applications are open till May 4
Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact