Agreed. Still - having letting your users send you pull-requests to the documentation is a good idea. My company apiary.io is building API documentation tools that take the open git repo benefits but generate a sensible-looking documentation.