We don't usually document arrays like this, everywhere else we just say the type is `Array`.  I'm not against the idea, but it's currently inconsistent.  I have no problem with this going into master, but we should write up an issue to discuss standardizing how we document arrays throughout the code.