task: #3627285 Setters return the object, revert() split in two, interface docblocks

Jean Valverderequested to merge
issue/display_builder-3627285:3627285-setters into 1.0.x

Closes #3627285

Merge request reports