Au cours de mes dernières expériences professionnelles, dans l'équipe de développement nous avons eu plusieurs discussions à propos d'une convention à adopter pour la PHP Doc dans nos codes, surtout avec le type hinting enrichi par PHP 7 (types scalaires des variables et type de retour autorisé). Certains pensent que le type hinting de PHP7 suffit amplement, d'autres pensent qu'il faut le mixer avec la php doc, d'autres pensent que selon les cas, la php doc peut être utilisée en complément. Un draft sur la documentation dans la psr 5 est en cours d'écriture mais n'impose pas un standard. Quelle conclusions faut il en tirer ? quelles solutions sont adaptées ? Une présentation de l'étude permettra aux développeurs de mieux documenter leurs codes et de comprendre certaines spécificités.
