Correction de phpdocs

Hop @rastapopoulos. Cette PR propose de corriger certaines coquilles/imprécisions/manque de clarté dans différents PHPdocs.

PAs impossible que d'autres suivent:

• si tu as validé d'ici là, bah ce sera une nouvelle PR
• sinon, bah je mettrais à jour cet PR