回答:
コードの変更によりマニュアルの説明が変更される場合はいつでも(PDF)マニュアルを更新します。リリースプロセスのマニュアル部分を更新するだけです。
ユーザーが製品の使用方法をマニュアルに頼って、製品が変更された場合、マニュアルの関連セクションも変更する必要があるのは常識にすぎません
私はあなたがエンドユーザーのドキュメントについて話していると思います。ドキュメンテーションを書くことは@ $$の苦痛であり、私は逆を説得するためにいくつかのテクニックを開発しましたが、それでもまだ問題があります。これは私がそれを管理しようとする方法です:
DoDのドキュメントの更新を統合します(完了の定義)
これにより、各ユーザーストーリーの完了時にドキュメントが最新の状態になります。
これが私たちが書いた完了の定義です。私は元のフォーマットを維持しようとしたので、あなたはアイデアを得ます。ホワイトボードに貼られたA4ページです。
---------- 8 <------------ここをカット------------ 8 <----------
交渉不可
リポジトリにコミットされた、80%の単体テストカバレッジのコード
該当する場合はスクリーンショット(1024x728、395x281、170x121および729x329)
該当する場合は機能の説明(50文字、100文字)
完全なエンドユーザードキュメント
新しいファイルが正しく更新された
---------- 8 <------------ここをカット------------ 8 <----------
もちろん、ドキュメントにレビュープロセスを追加できます。私たちには英語を母国語とする人はいません。
このように完了の定義の利点の1つは、製品が各ユーザーストーリーの完了時に出荷される可能性があることです。
組み合わせで、この技術を使用して、この1。
私の組織では、通常3種類のリリースがあります。
定義により、メジャーリリースには、オンラインとオフラインの両方で関連ドキュメントを配置する必要があります。私たちの追跡システムは、ドキュメントがチェックリストの大部分を占めることを保証します。
マイナーリリースでは、ユーザーの認識レベルで追加された新しいものについてのみドキュメントが必要です。したがって、特定のシナリオで時間の複雑さを軽減する可能性がある別のヒューリスティックを含めた場合、それをPDFに入れることは重要な呼び出しになる場合とそうでない場合があります。
エンジニアリングリリースは、ドキュメントがなくても実行できます。いくつかの非公式の使用上の注意は、始めるのに十分なはずです。