> I think the important question to answer is actually why should you produce good docs. I know it's not quite your point, but the article http://stevelosh.com

> I think the important question to answer is actually why should you produce good docs. I know it's not quite your point, but the article http://stevelosh.com/blog/2013/09/teach-dont-tell http://stevelosh.com/blog/2013/09/teach-dont-tell linked elsewhere (https://news.ycombinator.com/item?id=21339009 https://news.ycombinator.com/item?id=21339009) proposes: > The purpose of technical documentation is to take someone who has never seen your project, teach them to be an expert user of it, and support them once they become an expert.