*これは、コンテンツ・フレッシュネス・シリーズのパート2です。パート1では、なぜ鮮度が重要なのか、そして実際にどのような意味があるのかを説明しています。この記事では、その続きとして、賞味期限だけでは十分でない理由と、継続的なモニタリングとはどのようなものかについて説明します。
あなたが責任あることをするとしましょう。あなたが責任あることをするとしましょう。作成から6ヶ月、安定した参考資料の場合は12ヶ月かもしれません。日付が来ると、所有者は通知を受け取ります。
これはほとんどの会社がやっていることよりも良いことです。ほとんどの会社は何もしません。ドキュメントがそこに置かれ、ゆっくりと腐敗していき、誰かが指示に従って何かが壊れるまで誰も気づきません。
しかし、ここに不愉快な真実があります：**有効期限は必要ですが、まったく不十分です。**私は、文書が最後のレビューから数日後に危険なほど古くなるのを見たことがありますが、レビューの日付ではそれを捕らえられません。
##有効期限が実際に解決すること
有効期限は説明責任の問題を解決します。それは、次の質問に答えるものです：これがまだ正確であることを、誰が、いつ確認する責任がありますか？
これは本当に価値のあることです。これがないと、ドキュメンテーションは所有権の空白と呼ばれる状態に陥ります。レビュー日を設定することで、特定の日に一人の人間に一人の義務を課すことができます。シンプル。明確。効果的。
実際の有効期限はこんな感じです：
- 文書が作成され、90日後にレビューが行われます。
- 有効期限の14日前に所有者に通知
- 有効期限が切れると、文書に「要レビュー」のフラグが立てられます。
- オーナーがレビューし、まだ正確であることを確認し、期限を延長します。
- または、更新、再割り当て、アーカイブ化
これは堅実なシステムです。緩慢な腐敗、1年間誰も考えなかったドキュメントをキャッチします。定期的なレビューが行われます。オーナーシップの可視化
**しかし、大陸ほどの死角があります。
失効日が見逃すもの
レビューの日付と日付の間は、文書はブラックボックスに格納されます。あなたはそれを1月15日に見直しました。次の見直しは4月15日です。2月3日には、これらのどれかが起こる可能性があります：
リンクが無言で切れる
参照した外部URLが404を返しました。内部リンクがアーカイブされたドキュメントを指しています。コードリポジトリの名前が変更され、文書内の GitHub リンクがすべて無効になりました。ドキュメントはまだ正常に見えます。有効期限はあと2ヶ月もありません。リンクが切れていることを誰も知りません。
関連する内容の変更
あなたは、アーキテクチャドキュメントを参照するデプロイメントガイドを書きました。2月に、誰かがアーキテクチャドキュメントを完全に書き直しました。新しいパターン、新しいインフラ、新しい規約。あなたのデプロイメントガイドはまだ古いアーキテクチャを参照しています。技術的にはまだ間違っていませんが、漂流しています。レビュー日が来る頃には、そのギャップは大きくなっているかもしれません。
読者数はゼロに
あなたの文書は、かつては毎月40人に読まれていました。その後、プロセスが変わり、誰も必要としなくなりましたが、誰もアーカイブしていません。検索結果で場所を取り、時折、無関係だと知らない新入社員を混乱させます。有効期限は読者には関係ありません。予定通りに所有者にpingが送られます。
翻訳の遅れ
英語のソースは2月10日に更新されました。フランス語、ドイツ語、日本語の翻訳は現在古くなっています。しかし、これらの翻訳版の有効期限は5月までありません。3ヶ月間、英語以外のチームは古くなったコンテンツを読んでいることに気づかないのです。
読者が問題を指摘
ある読者がコメントを残しています：「CLIフラグは非推奨になりました。そのコメントはそのままになっています。有効期限はまだ数週間先です。次にドキュメントを読む人はそのコメントを見ないかもしれません。その次の人は間違いなく見ないでしょう。
**有効期限は予定されたチェックポイントです。これらは予定外の出来事です。この2つの間のギャップが、古くなった文書が最もダメージを与えるところです。
鮮度：継続的モニタリング
フレッシュネス・スコアリングは、有効期限のギャップを埋めるものです。90日に一度、ドキュメントの健全性をチェックする代わりに、フレッシュネスは継続的にドキュメントを追跡します。毎日、バックグラウンドで、誰も何もする必要がありません。
これがラセピの仕組みです：
すべての文書は、複数のシグナルから計算された0から100までのライブ鮮度スコアを取得します：
|--------|----------------|----------------|
| レビュー状況**｜ドキュメントがスケジュール通りにレビューされたかどうか｜基本的なアカウンタビリティチェック | 読者の傾向**｜実際に読んでいる人がいるかどうか｜読者が少ないということは、そのドキュメントが無関係である可能性を示唆しています。 | 編集の新しさ**｜ドキュメントが最後に更新されたのはいつなのか、関連するコンテンツとの比較｜周囲の知識ベースとの相対的なずれを検知｜翻訳アライメント｜ドキュメントが実際に翻訳されているのかどうか｜翻訳アライメント | 翻訳アライメント｜すべての言語バージョンが最新かどうか｜翻訳が古いということは、他の市場のチームが古い情報を元に作業していることを意味します。 | 読者フラグ**｜読者からの問題報告の有無｜クラウドソーシングによる陳腐化検知 | 相互参照**｜この文書がリンクしている文書自体が古くなっていないか？
各シグナルは全体のスコアに貢献します。ある文書は、レビュー日が数週間先であっても、今日リンク切れで鮮度ポイントを失う可能性があります。それが重要なのです。
この2つの連動性
有効期限と鮮度は競合するアプローチではありません。補完し合うものなのです：
賞味期限はガバナンス層です。有効期限**はガバナンスレイヤーです。誰かがスケジュール通りにこのドキュメントを見て、まだ正確であることを確認しなければなりません。内容*がまだ正しいかどうか、アドバイスがまだ健全かどうか、記述されているプロセスがまだ現実を反映しているかどうか。
フレッシュネス・スコアリングはモニタリング・レイヤーです。リンク切れ、翻訳ドリフト、放置された文書、世界が動いて文書が動かないときに起こる文脈の崩壊など、レビューの日付と日付の間にあるすべてのものをキャッチします。
これらを組み合わせることで、以下のようなシステムが構築されます：
1.すべての文書は、定期的なスケジュール（有効期限）で人間によってレビューされます。 2.レビューの合間に、自動化されたシグナルが問題を随時キャッチ（鮮度） 3.両システムは、誰もが見ることのできる単一の信頼スコアに反映されます。 4.このスコアは、検索における文書のランク付けや、AIツールがその文書をソースとして使用するかどうかに影響します。
スコアリングインパクト
ここからが実用的です。ラズパイでは、ドキュメントの鮮度スコアがその可視性に直接影響します：
- スコア 80-100:** 完全な可視性。検索結果に普通に表示されます。AIの回答ソースとして適格。フラグなし。
- スコア50-79:** 視認性低下。陳腐化インジケータ付きで検索結果に表示されます。AIツールはソースとしての優先順位を下げる可能性があります。所有者に通知されます。
- スコア50以下:**フラグ付き。検索結果で大幅に押し下げられます。AI回答から完全に除外。オーナーに緊急通知。
これはフィードバックのループを作ります。ドキュメントのスコアが下がると、オーナーはそれを修正するように促されます。リンク切れ、翻訳の古さ、読者数の減少、これらは6週間後ではなく、今すぐ注意を払うべき現実のシグナルなのです。
実例
あるシナリオを見てみましょう：
**月1日：**あなたの「インシデント対応プレイブック」は92点です。それは2週間前にレビューされ、すべてのリンクは有効で、読者数は多く、4つの言語バージョンはすべて最新です。
**3月8日：**誰かがエンジニアリング・ステータスのページを再構築しました。プレイブック内の3つのURLがリダイレクトされるようになりました。鮮度スコアは78に低下。オーナーは通知を受け取ります：「3つのリンク切れを検出しました。
**3月10日：**オーナーはリンクを修正。スコアは89に回復。
月15日： 英語版は新しいエスカレーションパスで更新されています。フランス語とドイツ語の翻訳が古くなりました（コンテンツハッシュの不一致）。スコアは74に低下。
月17日： 翻訳が更新されました。スコアは91に戻りました。
**3月20日：**読者データによると、日本語版は30日間アクセスなし。スコアは86に低下。微妙なシグナル。
**4月1日：**レビュー予定日。読者数シグナルがまだ存在するため、スコアは86のまま。
チームは問題を発見するために審査日を待ったことはありません。鮮度システムは数日以内に問題点にフラグを立てました。審査日はガバナンスのチェックポイント。どちらのレイヤーも役割を果たしています。
なぜ「レビュー日を設定するだけ」ではもう十分ではないのか
5年前なら、有効期限だけで十分だったかもしれません。ドキュメントは人に読まれ、人は判断することができます。文書が少しおかしいと思えば、周囲に問い合わせるでしょう。
今日、ドキュメンテーションはインフラです。AIツール、オンボーディング・オートメーション、コンプライアンス・システム、文脈のない結果を提供する検索エンジン。これらのシステムは判断を下しません。コンテンツをそのまま利用し、大規模に再配布するのです。
リンク切れや翻訳が古く、レビュー日まで3週間もあるようなドキュメントは、特にAIアシスタントが自信を持ってそのドキュメントに基づいた回答を提供する場合、その3週間で大きなダメージを与える可能性があります。
**有効期限は、ドキュメント・ガバナンスにとって最低限実行可能なアプローチです。鮮度スコアリングは、ドキュメントが自分で考えることができないシステムによって消費される場合に必要なものです。
はじめに
すでに文書に有効期限を設定している場合（ほとんどのチームは有効期限を設定していません）、鮮度を高める方法を説明します：
1.**リンクの追跡を開始します。その数はおそらくあなたを驚かせるでしょう。 2.**多言語の文書がある場合、ソースと翻訳の最終編集日を比較してください。1ヶ月以上遅れているものはいくつありますか？ 3.**トラフィックがゼロの文書はどれですか？それらはまだ必要ですか、それともアーカイブすべきですか？ 4.**社内にAIアシスタントがいるのであれば、どのような文書からソーシングしているか聞いてみましょう。そして、それらの文書の鮮度をチェックしましょう。
技術的に有効期限が切れていない文書には、有効期限では決して捉えられない問題がたくさんあることに気づくでしょう。
有効期限は、誰かがその文書を最近チェックしたかどうかを教えてくれます。鮮度は、その文書が実際に今元気かどうかを教えてくれます。一つはカレンダーのイベント。もう一つは生きているシグナルです。
両方が必要です。しかし、有効期限だけでは、チェックポイントとチェックポイントの間を盲目的に飛行しているようなものです。
文書はレビュー日に古くなるのではありません。古くなるのは、何かが変わって誰も気づかない瞬間です。鮮度スコアリングはそれに気づきます。
ラセピは、強制的な有効期限と継続的な鮮度監視を組み合わせています。全ての文書はリアルタイムで信頼スコアを獲得し、または失います。待ち時間も、盲点も、レビュー時の驚きもありません。
これは2部構成の第2部です。まだお読みでない方は、Part 1: The Metric Your Team Isn't Tracking. からお読みください。