著者はAIを活用したドキュメンテーションテストの新しいアプローチを開発しました。Markdownファイルでプロジェクトのチュートリアルとドキュメントを更新した後、その有効性をテストするためにAIの使用を検討しました。ChatGPTに、ドキュメントを読み込み、説明されているツールを使用しようとする隔離されたチャット環境を作成するように指示しました。AIはこれに同意し、新しいチャットの詳細なプロンプトを生成し、その進捗を監視しました。その後、AIは発見したドキュメントの不備について報告しました。例えば、LinuxおよびWSLのセットアップ手順を提供していたにもかかわらず、ツールの意図されたLinuxでの使用に関する明示的な記述がドキュメントに欠けていることを指摘しました。これにより、AIはWindows環境でツールを実行しようとし、著者による明確化が必要な暗黙の前提を浮き彫りにしました。著者は、AIに新しいユーザーとして行動させ、積極的にタスクを完了しようとし、遭遇した問題を報告させるこの方法を高く評価しています。これは単なる言葉遣いのレビューを超え、ドキュメントの従いやすさの実用的なテストを提供します。AIが無効な点を提示する可能性はありますが、どの変更を実装するかを決定する際には人間の判断が依然として重要です。著者は、ドキュメントは人間の読者とAIアシスタントの両方に役立つ必要があると強調しています。プロジェクトとのやり取りにAIを利用するユーザーが増えるにつれて、ドキュメントは直接的な人間の使用と、AIがユーザーを効果的に支援できるように、明確である必要があります。これは、AIのためだけに排他的に書くのではなく、ドキュメントがAIとのやり取りをどの程度サポートできるかを考慮することを意味します。最終的に、著者は、人間またはAIのいずれかのユーザーがタスクを達成するためにドキュメントを正常にフォローできるかどうかを評価することによって、コードと同様にドキュメントをテストすることを提案しています。この革新的なテスト方法は、将来のプロジェクトでドキュメントの効果を向上させるための新しい視点を提供します。