This shouldn't block this PR, because this PR just updates the comments, it doesn't introduce the parameter structure.

The parameter structure is like that because the custom searches should be able to allow path parameters, which aren't named, they are only ordered, hence the array. I believe there is more documentation about this in the SearchAPI.registerSearchType documentation.