The PostgreSQL documentation and the limitations of community
Here&#x27;s my perspective. I&#x27;ve been a technical writer (TW) for ~10 years. 3 at an IoT startup, 7 at Google.<p>&gt; The strengths of this process are also its weaknesses. A developer is, by definition, someone who spends the majority of their time doing development, which is to say writing code. Updating the documentation becomes a task that must be completed so that the code one has written can get committed so that one can move on to the next project and write some more code.<p>I may be misinterpreting, but I get the sense that the author feels that there is some kind of more optimal way to split up docs duties. IMO there is not. At least, not for reference docs. As the author said, the people implementing the code are in the best position to keep the reference information up-to-date.<p>If I grokked the rest of the article correctly, the author is essentially saying that the engineers have trouble writing and maintaining the other main types of docs [1] --- guides, tutorials, and overviews (explanations). It also sounds like they are having a &quot;too many cooks in the kitchen&quot; problem with pushing through changes to the other docs. I have a simple answer to that: hire some strong technical writers and make it clear to everyone that the TWs are Responsible and Accountable [2] for those docs. Also, make it explicit that the engineers are a Consulted role when it comes to guides &#x2F; tutorials &#x2F; overviews. Writing these types of docs is hard, specialized work. As the author said, the engineers have lots of other priorities. Of course, it&#x27;s a bit self-serving for a TW to say &quot;the solution is to hire TWs&quot; but I get the sense that people don&#x27;t realize that the easiest way to get good guides &#x2F; tutorials &#x2F; overviews is to hire people who have thought long and hard about those specialized tasks. If you want a good database, you don&#x27;t expect your TWs to do the job. You get a database engineer. If you want good tutorials &#x2F; guides &#x2F; overviews, you likewise shouldn&#x27;t expect your database engineer to do the job. You get TWs.<p>[1] <a href="https:&#x2F;&#x2F;diataxis.fr" rel="nofollow noreferrer">https:&#x2F;&#x2F;diataxis.fr</a><p>[2] <a href="https:&#x2F;&#x2F;en.m.wikipedia.org&#x2F;wiki&#x2F;Responsibility_assignment_matrix" rel="nofollow noreferrer">https:&#x2F;&#x2F;en.m.wikipedia.org&#x2F;wiki&#x2F;Responsibility_assignment_ma...</a>