Bonjour,
Je suis en train dans le cadre de mon boulot, de faire un comparatif entre quelques outils de documentation pour qu'on unifie notre doc technique au sein de la boîte.
Actuellement, nous utilisons principalement deux outils doxygen et sphinx plus toute une myriade d'outil adhoc quand on fait des POC (par exemple ldoc pour lua…).
Le principal problème à l'heure actuelle des outils de la seconde catégorie, c'est qu'ils ne possèdent pas de manière native de binding vers la génération de PDF là où doxygen et sphinx l'ont.
A l'heure actuelle, j'étudie sphinx pour comprendre comment mettre en place l'automatisation de la génération de la doc (pour la garder plus facilement à jour). J'ai un POC python forcément mais j'aimerai qu'on puisse montrer que ça marche aussi pour les autres langages.
Seul inconvénient : pour les autres langages, je ne trouve pas d'outil équivalents à autodoc. Enfin pour java, je peux passer par une commande intermédiaire qui génère des fichiers .ReST pour créer mes fichiers de docs avec les bons domaines (java:class, java:constructor…). Seul problème (mineur mais quand même) : comme on a une commande qui génère les fichiers .ReST, ces fichiers ne sont pas customisables (i.e on ne peut pas ajouter des remarques annexes ou bien notre sommaires comme on le fait avec autodoc).
Connaissez vous un outil équivalent à autodoc pour sphinx qui gère au moins un des langages suivants :
- java
- lua
- C
- delphi
- php
