私は基本的にPHPで開発された、もう1つの通常のWebアプリケーションであるWebアプリケーションを完成させました。通常、最終的な製品リリースを配信するとき、クライアントにコードドキュメントとアーキテクチャ情報を引き渡すだけです。ただし、この特定のプロジェクトの場合、クライアントは、プロジェクトに関する完全なデータの入出力を要求します。
だから私はただ疑問に思っています...コードとアーキテクチャのドキュメント以外にクライアントに提供できる必須の技術文書と非技術文書は何ですか?
(また、プロジェクトに関するさまざまな統計とデータについてクライアントに問い合わせて、関与する作業量と製品の実際のクールさを実際に知ることができるのも、ちょっとクールなことです。)
リストには以下を含める必要があると思います。
これらすべてがすべてのプロジェクトで利用できる(または必要である)とは限りませんが、これは優れた一般的なガイドだと思います。
FrustratedWithFormsDesignerの本当に良い答えに加えて、(私たちが行ったように)非技術ドキュメントには何が含まれているのかをお伝えしたいと思います。
あなたがした申し出:
あなたがしなければならないこととあなたが期待することについての一種の契約として一緒に機能する
開発中に提供するお客様、および推定の時間とコスト。
レビュープロトコル、ユースケースとテストプラン、テスト結果を含む仕様
uMLとそれに対応するすべてのドキュメントのデザイン
ソースコードのドキュメント(doxygenなど)
マニュアルとインストールのガイドライン
プロジェクトに使用されたリソースの実際の最終的な量(時間とお金)。請求書を作成できます。
一部の顧客は会議プロトコルも必要としています。これは、上記の「決定文書」の拡張です。
それがあなたが探していたものであることを願っています。
以下から、プロジェクトに該当するドキュメントのいずれかに従ってください。すでにいくつかのドキュメントを持っている場合があります。
技術文書:
スクリーンショット付きのドキュメントを準備し、次の関連コード(必要な場合)を強調表示します。
無効なデータを入力し、フロントエンドとバックエンドでデータの検証を行ったため、それが不可能であることを示します。/* This step is not applicable if you have not used any object for getting direct input from the user like Text Field as it is obvious that you cannot get invalid data through indirect input. */
関連するコードを説明して、サーバーまたはクライアントシステムに突然の障害が発生した場合に、プログラムにエラーがないこと、またはデータに不整合がないことを示します。
文書化する前にこれらを自分で確認して、クライアントがサンプルデータを使用してデモを要求した場合に、プロジェクトが実際にどのように機能するかを示すことができるようにします。また、フロントエンドコードに適切なコメント行があることを確認してください。
最後に、コードの合計行数、プロジェクトに費やされた合計日数、プロジェクトをチェックした合計回数、使用されているすべてのアプリケーションのリスト、その他の技術的および非技術的情報などの統計情報で締めくくります。
非技術文書:
あなたがクライアントに提供できる可能性のあるドキュメントは事実上無限です。まだ持っていないドキュメントを生成するために必要な追加の時間は未払いです。
なぜクライアントはこのドキュメント(ソースコードに加えて)を必要とするのですか?それで何ができるでしょうか?誰のためですか?
これらの質問に対する回答は、提供する対象の範囲を狭めるのに役立ちます。
提供するドキュメントと、追加の労力が補償されるかどうかについて、お客様とクライアントが正確に合意することが重要です。
推測ゲームをプレイしないでください。ほとんどの技術ドキュメントは、一般的な(技術以外の)クライアントには役に立たないでしょう。
私はおそらくこれをいくつかの文書カテゴリーに分けます:
ガイド:
サポート:
統合ポイント: