Isn't more phpdoc better than less? The particular case here provides method hinting in IDEs and assists static analyzers.