add warning about Mac OS X and pip (fix #10)
mention RPM package for client (fix #7)
update CIMI and Couchbase documentation