mvriel/Docblox — comment on commit 5befb87f36f136fd5c6a81418f610cf8d7da47f0
File: docs/PSR.md line 361
By ashnazg:

Depending on how precise you wanted to be in your tag, I could imagine these all being acceptable:
* @return array just saying "it's an array" is good enough... you're not interested in discussing element types in the array
* @return mixed[] equivalent to "array", but at least indicates that elements may be of mixed types inside the array

Carrying this further, I wonder if this syntax could be useful, albeit cluttered:
* @return mixed[]string|int equivalent to an array of mixed elements, but we specify that elements will only be either strings or integers