6

設計ドキュメントを最新の決定に合わせて最新の状態に保つ良い方法を探しています。

私たちは小さなチームです (2 人の開発者、ゲーム デザイナー、グラフィック デザイナー、プロジェクト マネージャー、営業担当者)。私たちのプロジェクトのほとんどは数か月続きます。プロジェクトの開始時に設計が行われますが、通常、プロジェクト全体で変更や新しい決定を下していることに気づきます。これらの変更のほとんどは改善であるため、そのようなプロセスを維持したいと考えています。(デザインの変更により時間がかかる場合は、通常は処理されているため、その部分は問題ありません)

しかし、現時点では、最初の設計ドキュメントへの変更をキャプチャする適切な方法がなく、その結果、コーディング中に最初の設計がソースとしてすぐに放棄されてしまいます。もちろん、これは労力の無駄です。

現在、私たちの文書は OpenOffice/Word であり、これらの文書の変更を追跡する最善の方法は、おそらく変更リストを文書の先頭に追加し、テキストの変更を並行して行うことです。これは理想的とは言えません。 .

私は要件管理ソフトウェアを見てきましたが、それは専門的なものに見えます。ドキュメントはSubversionに保存できますが、変更を洞察するにはレベルが低すぎると思います.

このような変更を追跡し、プロジェクト全体で設計ドキュメントを貴重なリソースとして維持する良い方法を知っている人はいますか?

編集: 現時点では、元のデザインの変更をバグトラッカーに入れることに主に依存しています。そのようにして、少なくともどこかに.

編集：関連する質問

4

5 に答える 5

3

ユーザーの数が比較的少ない場合、Word 文書からのステップアップとして、リビジョン ログ機能を備えた Wiki がうまく機能することがわかりました。簡単にすばやく編集できるものを見つけることは、最新の状態に保つのに役立ちます。

于 2009-03-24T16:21:54.297 に答える
1

openoffice と word の両方に、ドキュメントの編集内容を表示/非表示にする機能が含まれています。変更に対する抵抗があると仮定すると、それが最善の選択肢です。それか、テキストにエクスポートしてソース管理ソフトウェアに入れるかのいずれかです。\

または、変更の説明テキスト用に別の (適切なツールを使用して diff 可能な) ドキュメントを維持し、適切な時点でアーカイブ バージョンを保存します。

于 2009-03-24T16:31:43.540 に答える
1

この問題は、私たちのプログラミング ショップでも長年の問題でした。面白いことに、プログラマーはこれを間違った最適化の角度から見る傾向があります。私の意見では、2 つの主な問題があります。

  • 変更の説明は読みやすくする必要があります(「新機能は何ですか?」)。
  • このプロセスは、合意する仕様書を作成するために最適化されている必要があります。

この問題が別の環境、つまり政府の法律制定でどのように解決されるか想像してみてください。政府が別の法律を追加したり、変更したりするたびに、「変更の追跡」をオンにして、法律書が書き直されることはありません...

最善の方法は、リリースされたドキュメントには決して触れないことです。すべてを同じファイルに詰め込まないでください。次のようになります。

  • 恐ろしいバージョン履歴テーブル
  • 永遠のステータス「下書き」、
  • 散在する矛盾、
  • 恐ろしく急ぎ足の文章、そして
  • 著者のスタイルの悪臭のブレンド

代わりに、詳細な変更のみを説明し、場合によっては元の段落/ページ全体を置き換える補遺をリリースしてください.

私たちのプロジェクトの規模では、これはうまくいきませんよね？

これまでの私の最大のプロジェクトでは、1 つの基本仕様と 5 つの連続した追加をリリースしました。それぞれ5ページくらい。魔法のように働きました！

于 2009-09-10T10:16:46.600 に答える
0

無料の優れた構成管理ツールを知りませんが、設計をソース管理下に置いてみませんか? SVN、CVS、または使用しているものに追加するだけです。これは次の理由で優れています。

1) 常に最新の状態です (もちろんチェックインすれば)

2) 中央集権的である

3) ほぼすべてのソース管理システムで利用可能な組み込みの比較機能を使用して、変更を追跡できます。

これはあなたが望む「エンタープライズ」ソリューションではないかもしれませんが、あなたは小さな開発者チームなので、そのような状況では完璧以上のものです。

編集:ソース管理システムについて既に言及されているようですが、私の間違いです。それでも、うまくいくはずだと思います。

于 2009-03-24T16:24:55.770 に答える
0

Google ドキュメントを使用します。その無料の Web ベースのマルチユーザーはリアルタイムで、ドキュメントにアクセスできるユーザーを選択し、バージョン管理を維持できます。すべてのワード文書をアップロードして、それらを変換することもできます。詳細情報: http://www.google.com/google-ds/intl/en/tour2.html

于 2009-03-24T16:25:51.603 に答える