Well, I find that documenting the expected type of these is a good practice. And the syntax is understood by multiple IDEs so you are not trying to tie someone to PhpStorm (which I love).