Include reason for replication failure in _replicator doc

closes COUCHDB-1647

BugzID: 25824