Add some JavaDoc to NextState.
Change parameter order in NextState#retryWithActivation

reason is now last parameter, like in NextState other methods.