document what happens during an un/successful run

[ci skip]