Bonjour,
Je travaille pour une boite ou les softs sont développés en c, c++, c#, java, php, js, et un langage propriétaire qui abuse des macros préprocessées.
Comme il n'y a pas de convention de codage ni vraiment de spécifications de bas ou de moyen niveau, c'est vite le bordel.
Pour améliorer la situation je veux introduire des conventions de codage qui nous permettrai de générer des specs bas niveau (pour commencer).
J'ai vu que doxygen etait capable de traiter tout les langages cites précédemment.
Pour le langage propriétaire, la syntaxe est assez classique et les commentaires sont dans le style c/c++.
Le preprocessing se fait avec gcc.
L'idée est d'avoir une seule manière de faire pour tout les langages et générer et hiérarchiser simplement la doc de projets hétérogènes.
Si qq'un a une expérience bonne ou mauvaise de la gestion de doc avec doxygen dans un projet multi-langage, ou pour un langage non-standard
je serai très intéressé d'avoir son point de vue.
Je suis aussi intéressé par des retours sur un outil équivalent.
cordialement,
/JLB
Partager