added some documentation on when terminal_terminated is accurate