反復的なドキュメント開発は可能ですか?また、効果的なドキュメントを提供しますか?


11

大学向けのプロジェクトがあり、すぐには始めませんが、かなり長い間考えていました。大学のプロジェクト開発は産業のようなものではないことを理解しています(私は現在インターンです)。そのため、現時点で指摘する状況は、実際のソフトウェア開発者にとってはおそらくばかげているように思われます。^^ '

プロジェクト自体では、多くの作業を文書化する必要があります。したがって、いくつかのマークにカウントされるコードを配信することに加えて、次のようなドキュメントを配信する必要があります。

  • 要件分析ドキュメント
  • プロジェクト計画
  • ユースケース、オブジェクトモデル、動的モデル、および受け入れテストの計画リスト
  • テストプロセスのドキュメントとテストの成功度
  • 時間の使用などに関する他の議論と分析

これらの成果物は、次の方法で配信されます。

  • RADファースト
  • プロジェクト計画、ユースケース、モデル、およびテストが続きます(約3週間後)
  • 最後に、実際のプログラムのドキュメント、テストプロセスなど+実際のプログラミング自体(約5週間後)

だから、私が理解していることから、これはプロジェクトへのウォーターフォールスタイルのアプローチに向けられています。(私の意見では)唯一の問題は、これが大学のプロジェクトであり、学生がプロジェクト週の学期の終わりにプロジェクトを開発しようとするのと同様に、すでに十分なプレッシャーを持っていることです。学期の終わりにすべてをコーディング/開発/テストしたくはありません。私が対処しなければならない他の多くの評価でパニックに陥ります。

少なくとも、ある種の反復的な開発サイクルを試してみてください。つまり、コーディング/プロトタイピングを早期に開始でき、最後の瞬間にすべてを行うことに集中せず、このプロジェクトを終了する学期の終わり。そして今、私の実際の質問が来ます:

  • すべてのドキュメントを高速の反復/プロトタイピング開発サイクルで提供する必要性を何らかの形で調整できますか?
  • ドキュメントを反復的に生成するための戦略はありますか?
  • 私はこれを尋ねて、それが大学で実行可能になると期待しているのはまったく不合理ですか?

また、私はこの質問が非常にローカライズされていることを理解しているので、業界の観点から上記で質問したのと同じ質問をしたいと思います。または会社。

とにかく、これがどれくらい長いのかごめんなさい。最後まで読み終えたら、ありがとう!あなたが答えるために時間をかけることができれば、私は非常に感謝します!ありがとうございました!


2
これは無反応なので、答えとしては入れません。しかし、それをしないでください。あなたのインストラクターが望むことの一部は、あなたがあなたの思考を整理し、まだ書いていないシステムを計画し議論する能力を構築することです。これらは非常に優れたスキルであり、プログラミングビジネスに数年従事すると、非常に市場性が高くなります。
ロスパターソン

ああ、大丈夫。ただし、要件を取得し、クライアントソリューションを概念化するための計画方法には、可能な製品のプロトタイピングが含まれているように思えますが、これは計画と文書化の段階を進化または支援するのに役立つ方法ですか?それともそれは不合理な欲望ですか?
ブラフマン

2
確かに、プロトタイピングは有効です。実際、大企業では、プロトタイプを最終的なシステムの基礎として使用する意図がなくても、資本化されたR&Dを正当化するためのプロトタイプを作成することに気付く場合があります(技術的なものではなく、会計上のものです)。実際、最良のプロトタイプは、ガイダンスを提供し、その後破棄されるものです。数年後に全面的な書き換えを必要とする「製品化された」プロトタイプごとにニッケルがあれば、ニッケルがたくさんあります。
ロスパターソン

回答:


5

主な関心事(仕事に似た問題がある)は、「プロセス」が特定のアーティファクトを特定の時間に配信することを要求し、誰もが全能の「プロセス」に挑戦することを許可されていない場合、緩みます!より良い方法であるという単純な問題ではありません(反復的なドキュメントの開発はどれですか)。

だからあなたがする必要があるのはプロセス内で働くことですが、あなたが望むように働く方法も見つけてください。たとえば、プロセスは送信されたドキュメントの変更を許可しますか?そうでない場合、反復的な開発は不可能です。もしそうなら、あなたは(あなたの時間、あなたの信頼性などの点で)配達の費用について考え、その費用を管理する必要があります。たとえば、ファイルのコピーがそれ以上ない場合は、それを選択します。(私のように)ピアレビュー、改訂リリース、数十人の人々に影響を与え、数千ドルの費用がかかる場合は、慎重に検討し、新しいドキュメントが本当に価値を高めることを確認してください。

一般的な作業方法は、最初に「プロセス」のニーズを満たす最低限のドキュメントであり、その後、現実を反映するだけでなく、必要に応じて詳細を含む最終的な「そのままの」アップデートが続きます。コードがそれ自体について話す場所を簡単に説明します。


ご意見ありがとうございます!あなたが言ったことと、それを自分のプロジェクトにどのように適用できるかについてもう少し考えました。多くのドキュメントがあるため、期限までに提出し、その後に意味のある変更を加える必要はありませんが、クライアントに相談する必要があります。ただし、クライアントとの協議による反復的な開発はまだ可能ですか?つまり、それがサイクルで開発するポイントですよね?
-blahman
弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.