Rollup merge of #135895 - hkBst:patch-15, r=joboet

Document workings of successors more clearly

This is an attempt to fix #135087 together with rust-lang/rust#135886, but I am not sure if I've succeeded in adding much clarity here, so don't be shy with your comments.