Formato de documentación de código estandarizado, ¿dónde está? [cerrado]

7

Actualmente estoy analizando las herramientas de generación de documentación de la API y noté que aparentemente no se están realizando esfuerzos en la estandarización.

El estilo de

Javadoc es una especie de convención ubicua ... se usa para Java (duh), PHP (< a href="http://www.phpdoc.org/"> PHPDocumentor , doxygen , Stubbles ), C / C ++ (doxygen de nuevo) ... e incluso hay IDE Soporte para ello incluso en otros idiomas que no son java.

Incluso NaturalDocs , que tiene una sintaxis completamente diferente para la documentación, tiene cierta compatibilidad para ello.

Entonces, mi pregunta es: ¿se están realizando esfuerzos para estandarizar la sintaxis de la documentación en código? , que a su vez se puede usar para generadores de documentación o metadatos de idioma en diferentes idiomas?

    
pregunta dukeofgaming 08.05.2012 - 03:51

1 respuesta

3

Voy a arriesgarme y diré que no hay ninguno, e incluso si lo hubiera, sería ignorado porque la comunidad de programación es demasiado diversa y está de acuerdo con todos para estar de acuerdo en algo. Dicho esto, la familia JavaDoc / Doxygen es lo más cercana que es probable que lleguemos. Es posible que veamos algunos campamentos grandes en desarrollo, pero eso es todo.

    
respondido por el Randall Cook 08.05.2012 - 08:46

Lea otras preguntas en las etiquetas