Document Transition Object

[scott-w]

The transition argument is used a log without any insight into what its API should look like.

For this, we should document the most useful fields such as where to find the transition arguments, routes, etc.