Include reason for replication failure in _replicator doc

closes COUCHDB-1647

BugzID: 25824
Merge pull request #27 from cloudant/return_error

Include reason when replication ends in an error state