Merci de relancer le truc 
( 3 ans + tard ) ( je suis un précurseur )
Pour reprendre ici les arguments de Salviaf, en tout cas ceux auxquel j’adhère aussi :
- phpdoc en anglais, on sait jamais, si un jour Jeedom s’internationalise vraiment. En attendant ça peut motiver des non-francophone à plonger dans le code et participer…
- supprimer les TODO et autres projets de roadmap (j’allais dire des plans sur la comète) car c’est plutôt des sujets à lancer sur le community (où on peut aussi discuter technique) ou dans une issue github
- remplacer les exemples trop longs par des @link vers la doc developpeur de Jeedom: https://doc.jeedom.com/fr_FR/contribute/core que l’on pourra également enrichir en lien avec cette phpdoc.
Le but est d’avoir une phpdoc succinte qui n’entrave pas la lecture du code. Mais sur le principe oui c’est vraiment un plus, et j’ai même fait un preview de ta PR
https://pifou25.github.io/jeedom-core/classes/ajax.html
par rapport au truc actuel qui nous sert de phpdoc:
https://doc.jeedom.com/dev/phpdoc/4.4/classes/ajax.html