LWN.net's Journal

[$] Improving communities through documentation
Documentation, said Riona MacNamara at the beginning of her Open
Source
Summit Japan 2019 talk, is the superpower that we can use to energize users
and developers; it is an important part of the creation of a vibrant and
inclusive community. While there are a number of roadblocks that can impede
participation in a development community, many of those can be addressed
with better documentation. The talk was a call for all projects to think
about what they are trying to accomplish and to ensure that their
documentation is helping to get there.