決めたことを残す13 / 20
すべてのバージョンを振り返る
このページの内容
意図ドキュメントへの変更は、すべて残ります。バージョンを選ぶと、どのドキュメントが変わったか、それぞれ何が変わったか、あなたが編集したのか、Agent が提案してあなたが承認したのか、そして当時その文章がどう説明されていたかが分かります。どう決めてきたかは、すべてそこにあります。
ドキュメント履歴を開く
入り口は三つあります。
- サイドバーの「意図」の見出しにポインターを合わせ、履歴ボタンをクリックする。
- 表示 → ドキュメント履歴 を選ぶか、
⌘Y（Windows と Linux ではCtrl+Y）を押す。 - 「これは以前のテキストの説明です」と表示されたノートで、「ドキュメント履歴で見る」をクリックする。
最初の二つは、サイドバーを切り替えて最新のバージョンを選ぶだけで、メインエリアはそのままです。三つ目は、このドキュメントを変更した最新のバージョンを選び、現在のドキュメントを、そのバージョンのドキュメントにその場で置き換えます。
履歴を見ている間も、メインエリアのタブ、左右に並べたレイアウト、コードパネル、チャットはふつうに使えます。サイドバー上部の「ドキュメント履歴を閉じる」をクリックすると、ふだんのサイドバーに戻り、履歴のタブも閉じます。
バージョンの由来
意図ドキュメントへの変更の一つひとつが、一つのバージョンです。由来別には、次のとおりです。
| 由来 | 一覧でのタイトル |
|---|---|
| 提案を承認した | 提案のタイトル。たとえば「猶予期間の開始時にチームのオーナーにメールを送る」 |
| 整理案を承認した | 整理案 |
| Noea で保存した、または Noea の外でファイルを変更した | 手動の変更。連続した手動の変更は、次の説明が終わるまで一つのバージョンにまとまる |
| 変更されたすべてのドキュメントが、すでに記録された状態に戻った | 「そのバージョンのタイトル」に戻る |
| 記録を始めたときのドキュメント | 記録開始 |
バージョンの一覧を読む
履歴では、サイドバーの下半分がバージョンの一覧になり、日ごとにまとめられ、新しいものが先頭に来ます。各バージョンは二行で、タイトルの下に、時刻、状態のアイコン、由来のアイコン、変更したドキュメントの数（たとえば「2件のドキュメント」）が表示されます。
- 時刻：手動の変更のバージョンは、最初の編集から最後の編集までの期間を表示し、閉じるまでは「進行中」と表示されます。
- 状態：説明済み、調査中、未説明のいずれかで、このバージョンの文章に説明があるかを示します。ポインターを合わせると、どれかが分かります。
- 由来：あなたの編集と Agent の編集を見分けられます。以前のバージョンに戻る場合には、専用のアイコンがあります。
サイドバーの上半分は、これまでどおりドキュメントツリーで、入れ子も展開も同じです。選んだバージョンが変更したドキュメントには、印が付きます。
| 変更 | 印 |
|---|---|
| 作成 | 名前の横に緑の点 |
| 変更あり | 名前の横に黄色の点 |
| 削除 | 最後にあった場所に、赤の取り消し線で薄く表示される |
| 名前変更 | 新しい名前で、横に古い名前が薄く表示される |
当時のままのドキュメントを開く
バージョンを選び、ツリーのドキュメントをクリックすると、メインエリアに、そのバージョンのときの姿で開きます。履歴のドキュメントは読み取り専用で、タイトルの横に鍵が付き、ポインターを合わせるとどのバージョンか分かります。レイアウト、アウトライン、検索、ノートはふつうに使え、テキストの選択とコピーもできます。
ドキュメントには、このバージョンが一つ前のバージョンから変えた内容が、レビューモードのスタイルで示されます。追加、書き換え、削除で、削除された段落はその場に残ります。下部で順にたどれます。
このバージョンがそのドキュメントを変更していなければ、それ以前の最後の変更時点の内容が、元になった時刻とともに表示されます。このバージョンにまだドキュメントがなかった場合や、このバージョンが削除した場合も、そのように表示されます。
別のバージョンを選ぶと、開いている履歴のドキュメントがそれに追従し、そのバージョンのときの同じドキュメントを表示します。履歴のタブは、ウィンドウに一つだけです。
当時の説明を見る
履歴のドキュメントの各段落には、そのバージョンの文章についての説明が表示されます。段落があとで書き換えられたり削除されたりしていると、そのノートは「このバージョンの文章についての説明です」と表示して開きます。説明しているのは当時の文章であり、いまのドキュメントではありません。このバージョンでまだ説明されていない段落には、「まだ説明がありません」と表示され、調査中の段落には「調査中」と表示されます。
これで、「当時、なぜそう実装されたのか」に答えられます。たとえば3週間前に猶予期間の提案を承認したとき、その説明には、7日を168時間として数える選択が挙がっていました。それがチームのタイムゾーンの暦日に変わったのは、そのあとのことです。
以前のバージョンに戻したいとき
ドキュメント履歴は振り返るためのもので、「このバージョンに復元」はありません。戻したいときは、履歴のドキュメントからテキストをコピーし、現在のドキュメントに貼り付けて保存します。または、チャットで Agent に、段落を以前の表現に戻す提案を起草させ、レビューしてから承認します。
意図フォルダを Git で管理しているなら、Git でファイルを復元することもできます。すべてのドキュメントが記録済みの状態に戻ると、バージョンの一覧に「「…」に戻る」というタイトルの項目が表示されます。