News for hackers. Stuff that matters.
Re:Twitter’s poor API documentation practices by jroseattle on Monday January 09, 2012 @08:16PM (#3445178)
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.

Re:Twitter’s poor API documentation practices by bentlegen on Tuesday January 10, 2012 @01:14AM (#3445921)
I look forward to seeing your perfectly-documented API product.
Re:Twitter’s poor API documentation practices by jroseattle on Tuesday January 10, 2012 @02:43AM (#3446092)
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."