Include reason for replication failure in _replicator doc

closes COUCHDB-1647