多くのビジネスロジックルールを扱う際のプロジェクトのドキュメント。どのようにそれを整理する？

Question

私はかなり複雑なプロジェクト、ビジネスロジックの量とコンポーネントの量の面で取り組んでいます。

各開発者は、ほとんどが「自分の」コンポーネントで動作します。私はこれがあまり機能的ではないことを理解していますが、すべてのコンポーネントの詳細を知ることは不可能です。

チームsostavは時折変更されます。だから私たちは、ある人が「他人のコンポーネント」で作業しなければならない状況があります。これは定期的な地下に置くことができるので、1か月後に問題に戻ることができます。その瞬間に、コンポーネントビジネスロジックの所有者に何度も何度も同じ質問を繰り返してもらうことができます。後で。

この状況は時々厄介です。

私たちはのスタンドアップミーティングを持っています。 プロジェクトのwiki F.A.Q.があります。ページ - 最もよくある質問を抽出します。

この問題についてどう思いますか？

それを解決するにはどうすればよいですか？共通フォーマットでのアプリケーションの目的を指定する枠組み文書、セットアップ、要件など 2）

1）各コンポーネントのモジュールの文書は、とでインデックス付け：私は行くと思いコンポーネントの性質を与え

Answer 1

名。モジュール/コンポーネントのドキュメントの良い例のための良い一般的なドキュメントの例とhttp://docs.python.org/modindex.htmlためhttp://docs.python.orgで

ルックああ、毎日の会議は、一般的に悪いです

、彼らは多くの時間を取ると回答を忘れます。新規参入者または病気の人々は会議を逃し、再度説明する必要があります。ディスカッション/フィードバックが必要な場合を除き、すべてを書き留めて、ペーパー/メールのトレイルを維持する方が100倍良いです。