The official documentation has moved to http://docs.couchdb.org — The transition is not 100% complete, but http://docs.couchdb.org should be seen as having the latest info. In some cases, the wiki still has some more or older info on certain topics inside CouchDB.
This is a list of known issues and problems with couchdb - that may enlighten or clarify a bit which features are not 100% yet.
This list is mainly targeted the would-be couchdb users that are researching and planning. Also - this list is probably not complete.
Replication across WAN is unstable when dealing with larger datasets and will fail hard at some point (https://issues.apache.org/jira/browse/COUCHDB-690)