document the route factory behavior