プロジェクトが凍結-私の後の人々に何を残すべきですか？

ですから、私が取り組んでいるプロジェクトは今、無期限に凍結されます。プロジェクトが再びフリーズ解除された場合、そのプロジェクトが私または現在のチームのメンバーに割り当てられない可能性があります。実際、以前に凍結した後、プロジェクトを継承しましたが、プロジェクトの基本的なニーズを理解するのに役立つ前のチームには何も残っていなかったため、プロジェクトをよく知るために多くの時間を無駄にしました。私の質問は、私たちの後の人々がプロジェクトのニーズ、私たちがやったこと、なぜやったのかなどを最もよく理解するのを助けるために何をすべきだと思いますか。このプロジェクトで動作する他のトラックへのいくつかのトラック。

すでに行ったいくつかの手順：

• 技術文書（完全ではありませんが、少なくともいくつかあります）。
• ソース管理システムの履歴。
• プロジェクトのどの部分を改善する必要があるのか​​、そしてなぜそうするのかについての見積もり。
• ユニットテストの束。
• 私たちがやったすべてのチケットで問題トラッカー（EDIT）

私たちがすでに準備していること、他に何ができるかについてどう思いますか？

考慮すべきこと

• プロジェクトのディレクトリ構造は正常ですか？コードのコメントを修正しましたか？コミットログは何らかの形で提示可能ですか？
• 専門的な目的の概要（開始した技術ではなく）、プロジェクトの読み方、プロジェクトの履歴（開発サイクル、以前のプロジェクトマネージャー、スタッフのリスト、要件/機能仕様）
• UML図、クラス図、ワークフロー図！
• プロジェクトが凍結された理由は常に素晴らしいです。
• 開発環境、使用されたIDE、ビルドツール、これらは技術文書で説明されていますか？

最近受け継いだプロジェクトで見たいと思っていたもののいくつかを考えました。あなたがすでに提供したものは、私が得たものよりもはるかに多くの地獄です。次のチームを支援するための主要なカルマポイントを受け取ります:)

他の誰かが置いたプロジェクトを取り上げるときに私が持ちたいものは次のとおりです。

ツールチェーン内のすべてのツールの最新の既知の作業バージョンを含む、ビルド手順。コンパイラー、IDEなどは時間の経過とともに変化します。以前の開発者が立ち上げて実行する方法についての指示を残しておけば、作業がずっと簡単になります。

実行環境の指示-この実行には何が必要ですか？再び役立つバージョンの言及。私は最近、特定の場所にある特定のファイルのセットを必要とするものを拾い上げ、それを理解するために他の開発者にクイズをしなければなりませんでした。他の開発者が利用可能だったので大したことではありませんが、彼がいなかったら、それは問題だったでしょう。

リポジトリにコミットされたコードが実際にチェックアウトおよびビルドを行うことをある程度保証します。以前の開発者（幸いなことにまだ）がMakefilesで本当に奇妙なことをして、クリーンなチェックアウトからプロジェクトをビルドできなかったプロジェクトを選んだことがあります。言うまでもなく、実際に作業を行う前に、まずそれを修正する必要がありました。以前の開発者が利用できなかった場合、そのハードルを乗り越えるのにもっと時間がかかったかもしれません。

プロジェクトの意図の一般的な声明。このソフトウェアの目的は何ですか？合理的な限り短いですが、ある種の概要は本当に役立ちます。

スクリーンキャスト

私が最後の仕事を辞めたとき、私は実際に未編集のスクリーンキャストを行いました。チームを部屋に連れて行き、コンデンサーマイクを設置し、オーディオとスクリーンの録音中にプロジェクトについて知っていることをすべて説明しました。それから、彼らにそれについて質問させてください。座って1日中できるだけ早く入力しようとした場合よりも、はるかに多くの情報を記録することができました。

情報を知りたい場合は、ビジネス要件を追加してください。

1. 顧客は何を望んでいましたか？
2. 変更はそれをどのように促進しましたか？
3. お客様のニーズを満たす上での課題は何でしたか？
4. どのようなニーズが満たされなかったのですか？

実行中のスタンドアロン開発システムの仮想マシンイメージ（つまり、vm-ware）は非常に価値があるかもしれません。

昨年、私はいくつかのvb3コードを修正するように頼まれました。vb3、windows95、およびインストールされた多くのole-controlsを使用して実行中のシステムを再作成することは非常に困難でした。一週間後、私はあきらめた:-(

[更新] 新しい仮想マシンプレーヤーで再生できるように、古い仮想マシンイメージを変換した経験のある人はいますか？

また、最新のハードウェア/ゲストOSで非常に古いイメージを実行することはもうできないかもしれないことを考慮する必要があります。