Clarify willTransition docs