add jsDoc for router functions