2011-01-02 7 views
3

私たちは開発チームであり、私たちのコードを文書化する必要があります。 各開発者は、モジュールと呼ばれるコードの一部で動作します。 我々は彼女/彼自身の作品 開発ドキュメント

  • 各開発者のドキュメントを実装し、使いやすくする必要がありますし、他の開発者が任意のモジュールについて知る必要がある場合、彼/彼女は「shouldnこの仕様

    1. を持っているドキュメントが必要オリジナルの開発者にドキュメンテーションについて尋ねる義務があります。彼/彼女は自分/自分で文書を見つけることができるはずです。
    2. ドキュメント全体を検索できるはずです。

    ご意見はありますか?

  • +1

    これは本当に言語エコシステムに依存します。言語および/またはプラットフォームを指定すると、より良い回答が得られる可能性があります。また、「付随的な」ドキュメンテーションの生成、取り扱い、保管戦略も考慮する必要があります。 –

    答えて

    4

    ほとんどの言語では、コードコメントからドキュメントを作成する方法があります。 JavaとJavaScriptの両方には、コメントをJavaのJavadocなどのAPI仕様に変換する方法があります。実際には、使用しているプラ​​ットフォームによって異なります。

    +0

    実際。同じことがVS/.NET、Scala、Perl、Python、Rubyなどにも当てはまります。言語とエコシステムは、「容認された」(使いやすい)ツールが果たす役割に本当に関わっています。 –

    1

    デザインの決定、要件などについてお話しますか?

    このようなコラボレーションにwiki(PmWikiを使用)を使用してみませんか?

    関連する問題