Si tu veux absolument mettre de la documentation de paramètres, tu es mieux d'utiliser le format de la PhpDoc (tu peux la générer automatiquement avec PhpStorm).