次のシナリオで何を提案しますか。
複雑なシステムを構築および設計するには、多数の開発者が必要です。この設計は、将来の開発者のために文書化する必要があり、設計上の決定に注意する必要があります。これらのレポートは、約 2 か月ごとに作成する必要があります。私の質問は、このプロジェクトをどのように文書化するかです。
2つの可能性が見えます。各開発者は、設計と統合に役立ったことについて書き、1 人がこれらのドキュメントを 1 つにまとめます。すべてを組み立てる任務を負っている担当者は、すべての部品を調整する時間があまりないため、最終的なドキュメントはおそらく一貫性がなかったり、冗長になったりすることがあります。
各開発者からのドキュメント パーツが締め切りの数日前に届くとします。締め切りの数日前まで読むものがないため、共同システム (つまり wiki) は適切に機能しません。
それとも、チームの残りのメンバーが実際のシステム開発に取り組んでいる間に、少数の人 (2 ～ 3 人) がドキュメントの作成を担当する必要がありますか? 開発者は、設計上の選択と結論をテクニカル ライターに伝える方法が必要です。これを効率的に行うにはどうすればよいでしょうか。