* adapt revert reason convention * add whitespace * tweak documentation * fix tests
Co-authored-by: Francisco Giordano <frangio.1@gmail.com>