Posted on 05-07-2014
I heard an interesting statement this week at APIDays Berlin that I’ve heard before, "API document is an bug not a feature". The logic behind this is that if you design a proper API, using proven REST and hypermedia patterns, you shouldn’t need documentation. While this is true, and I agree with 100%, it ignores the vital process of getting the average person up to speed--simply stating that what many of us are actively doing, and what we currently know is a bug. I work with any folks who barely know what an API is, or what JSON is, yet......read more.