3 ms·
Doc writing is a canary for how well an organization puts its money where its mouth is. Not only is documentation sometimes outright neglected, it's most often
by stcredzero 14y ago
Doc writing is a canary for how well an organization puts its money where its mouth is. Not only is documentation sometimes outright neglected, it's most often taken into an "uncanny valley" of plausibly looking like decent doc, but still sucking when actual programmers use it.
If an organization is really serious about documentation, they will not only devote resources to writing it, they will also devote serious attention to a mechanism for figuring out where it needs improvement.
Come to think of it, this would be a decent metric for figuring out which big software companies to invest in, especially if you can detect the "uncanny valley" docs efficiently. (Not only equity, but in use of their SDK/APIs.) For small software companies, there may not be enough people to write docs at first.