Add some docs for the new reset behaviour

Signed-off-by: Sam Phippen <samphippen@googlemail.com>