Lorsque j'ai présenté mon parseur AS2, kalysto a lancé l'idée de créer un format de documentation du code, sur la base de JavaDoc. L'idée n'est pas forcément neuve, et Grant Skinner dans son application gModeler (application de diagrammes UML en Flash) à déjà initié ce type de commentaires. :)

Seulement, le format FlashDoc a pour inconvénient de ne pas être libre de droits, et qui plus est dédié à l'AS1. :? Commenter des classes AS1 nécessite de préciser dans la documentation les types de variables, noms de classe, etc... Ce qui n'est plus nécessaire avec l'A2, étant donné que le typage fort, la déclaration de classes et la répartition du code par fichier donnent déjà un grand nombre d'informations.

Nous travaillons donc ensemble à l'élaboration d'un tel format de commentaires, trés proche de JavaDoc, ainsi qu'un parseur qui pourra générer un document XML a partir du code AS, qui lui-même pourra ensuite être mis en page par une feuille de style XSL ... Pour la peine, je suis en train de redévelopper complètement mon parseur AS2, avec deux aspects : un aspect analyse du code (classe, dépendances, méthodes, propriétés) et un autre aspect servant à la colorisation et à la mise en forme du code (blocs d'instructions, chaine de caractères, commentaires, etc...)

J'ai ensuite l'intention de créer un outil basé sur le parseur, qui permettra d'aider à la documentation du code ... Le format XML aidant, cet outil pourra être en PHP et en Flash ! 8)

Les premiers résultats de ces travaux devraient être disponibles dans pas trop longtemps ... :)