Heh, I copied and pasted this from the existing controller docs (for `transitionToRoute`). Not ideal, I agree. But this is currently the "conical" way of documenting this, and it's used everywhere including `link-to` etc (iirc).

Would you like me to tackle that here also, or do that in another PR? (Need to think about this, conveying this in one sentence is not trivial.)