ApacheCon North America 2014

A common complaint against many open source projects is documentation. Insufficient, incorrect, non-existent, hard to find, and difficult to update are things we typically all hear. There are a lot of different ways to tackle these problems. There's no silver bullet but one of my favourite tactics is lowering the barriers for absolutely anyone to contribute documentation.

Ideally, lowering the barriers means:

* using a common and well understood documentation markup language
* using documentation editors that are commonly available
* not requiring your contributors to install and configure tools
* providing a preview of the updates to make reviews reviews easier

Learn how Apache jclouds has enabled walkup contributions to our project documentation. We've benefited from better documentation, shorter review times, and building community through contribution.