Feedback Without Noise
Mark Lewin is a technical writer and trainer and the author of books and training courses on various programming topics. He currently works on the documentation team at Vonage. He has a particular interest in web mapping APIs, probably due to his terrible sense of direction.
When he’s not hunched over a keyboard he likes to act (badly) in a local drama group and take his kids on one of his now-infamous “circular walks”, where the true answer to the question “Are we there yet?” is “I haven’t got a clue”.
How do we know how good are API docs are? We ask for feedback! But getting developers to provide helpful feedback can be like getting blood out of a stone. Let us share how, after many failed attempts, we finally hit on a way to get useful and actionable feedback on our docs.