News for hackers. Stuff that matters.
Re:API Documentation and the Communication Illusion by zer00eyz on Wednesday May 11, 2016 @02:42PM (#11678020)
Hey guys lets write documentation first, it will be great and clear everything up.

Isn't this how waterfall development was/is supposed to work.

Re:API Documentation and the Communication Illusion by clay_to_n on Wednesday May 11, 2016 @06:36PM (#11679922)
Based on organization structure, and your timing, there's a point where it's necessary.

If you have separate teams designing the client and server, you'll eventually get to a point where you need to agree on the messages passed.

Re:API Documentation and the Communication Illusion by Ysx on Wednesday May 11, 2016 @02:48PM (#11678074)
Unless you have an infinite number of monkeys, there's likely some design to your API. This doesn't need to be documentation, but it can be.