Formato di documentazione del codice standardizzato, dov'è? [chiuso]

7

Attualmente sto esaminando gli strumenti di generazione di documentazione API e ho notato che apparentemente non ci sono sforzi in corso nella standardizzazione.

Lo stile

Javadoc è una specie di convenzione onnipresente ... è usato per Java (duh), PHP (< a href="http://www.phpdoc.org/"> PHPDocumentor , doxygen , Stubbles ), C / C ++ (doxygen di nuovo) ... e c'è persino IDE supporto anche in altre lingue che non sono java.

Anche NaturalDocs che ha una sintassi completamente diversa per la documentazione ha una certa compatibilità per questo.

Quindi la mia domanda è: ci sono degli sforzi in corso nella standardizzazione della sintassi della documentazione in-code? , che a sua volta può essere utilizzata per generatori di documentazione o metadati della lingua in lingue diverse ?.

    
posta dukeofgaming 08.05.2012 - 03:51
fonte

1 risposta

3

Ho intenzione di uscire su un ramo e dire che non ce ne sono, e anche se ce ne fosse uno, sarebbe ignorato perché la comunità di programmazione è troppo diversificata e motivata per essere d'accordo su qualcosa. Detto questo, la famiglia JavaDoc / Doxygen è il più vicino possibile. Potremmo vedere alcuni grandi campi sviluppare, ma il gioco è fatto.

    
risposta data 08.05.2012 - 08:46
fonte

Leggi altre domande sui tag