Who believes that documentation should be treated as a first-class citizen among product features? It is not just that it helps with the increased effort requirements in adoption, integration, troubleshooting, and maintenance. Documentation pages showing the real-life use cases a tool handles best is a prime indicator of its value to people judging whether to consider it, and these people might not be technical at all.
commit cec4c3f
I'm strong believer in this. In one of my last teams they called me the
README.md shamer.