add docs for playing nice with couchdb