Unified return object for write operations #729
improvements after review
clarified replace return attributes