Ask HN: Does code documentation increase contributions?
To me, the composition of a community is probably not a technical issue and is more likely to be a social issue. In a way, this question sort of highlights the social versus technical gap.<p>The identified problem is lack of new outside contributors. The proposed solution:<p><pre><code>  1. mandates more work by existing contributors.
  2. does not directly recruit outside contributors.
  3. is structured to require a cultural shift of
     the existing community.
  4. is a hypothetical without support from reasonable
     evidence.
</code></pre>
To put it another way, what I see from across the internet is a community that makes changes by argument rather than consensus, and reaches out to the world of potential contributors for support to win the argument. It doesn&#x27;t seem to be so much about writing good documentation or determining what documentation is actually necessary for the purpose. It&#x27;s more rallying the troops.<p>Curious about what the project is and why someone might want to contribute.<p>Good luck.