[DOC release] Document final argument for transitionTo/transitionToRoute.

Adds documentation for a final options argument for the
`Controller#transitionToRoute` and `Route#transitionTo` methods.
Merge pull request #9993 from misteroneill/docs-transition-to

[DOC] Document final argument for transitionTo/transitionToRoute