Documentation updates for dynamic API

Includes some more thoughts on how to handle runs/arrivals as following
the same pattern as routes/movements.