add docs about revert/cancel operation