web-dev-qa-db-ja.com

標準化されたコードドキュメント形式、それはどこにありますか?

私は現在、APIドキュメント生成ツールを調べていますが、どうやら標準化に向けた取り組みが行われていないようです。

Javadoc スタイルはユビキタス規約の一種です... Java(duh)、PHP( PHPDocumentordoxygenStubbles )、C/C++(doxygen again)...そしてIDE support Javaではない他の言語でもそれのために。

ドキュメントの構文が完全に異なる NaturalDocs にも互換性があります。

だから私の質問は:コード内のドキュメント構文の標準化に取り組んでいますか?これは、ドキュメントジェネレーターまたは言語メタデータに使用できます。異なる言語間?.

7
dukeofgaming

私は手足を出し、それがないと言います。それがあったとしても、プログラミングコミュニティは多様性があり、すべてが何かに同意するには意見が多すぎるため、無視されます。そうは言っても、JavaDoc/Doxygenファミリーは、私たちが入手する可能性が最も高いものです。いくつかの大きなキャンプが発達するのを見るかもしれませんが、それだけです。

3
Randall Cook