Provide examples

Mozilla has really good documentation (e.g. JavaScript). Their examples cover most of the common scenarios. The syntax used on all of these pages is very confusing because it's not clear what makes a complete statement.

Other good examples of great, easy to understand documentation are Python and PHP documentation.

The easier it is to understand how to use couchbase the more people would be able to adopt couchbase and likey to use it. I was really hooked at first by the capabilities, but I am turned off by how sparse and hard to understand the documentation is.