1802978 - Migration JSDoc comments should be more precise about array types

Status: NEW

(Firefox :: Migration, task, P1)

Description

[Mike Conley (:mconley) (:⚙️)]

In https://phabricator.services.mozilla.com/D163133#inline-899335, kpatenio noted that we're being a bit inconsistent about how we declare array parameters and return types in some of our JSDoc. In some places, we're using things like @returns {object[]} and in others, we're using @returns {Array}.

I agree with her that we should try to be more consistent here, and try to update our documentation to use the former variant when possible to make it clearer what array parameters and return types contain.