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 per la standardizzazione della sintassi della documentazione in-code? , che a sua volta può essere utilizzata per i generatori di documentazione oi metadati della lingua in diverse lingue ?.

    
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 varia e motivata per essere d'accordo su qualcosa. Detto questo, la famiglia JavaDoc / Doxygen è il più vicino possibile. Potremmo vedere alcuni grandi campi svilupparsi, ma il gioco è fatto.

    
risposta data 08.05.2012 - 08:46
fonte

Leggi altre domande sui tag