결정 간직하기13 / 20
모든 버전 되돌아보기
이 페이지의 내용
의도 문서의 모든 변경은 보관됩니다. 버전을 하나 고르면 어떤 문서가 바뀌었는지, 각 문서에서 무엇이 바뀌었는지, 당신이 직접 고쳤는지 아니면 Agent가 제안했고 당신이 수락했는지, 그리고 그때 글이 어떻게 설명되어 있었는지를 볼 수 있습니다. 어떻게 그렇게 결정하게 되었는지가 모두 남아 있습니다.
문서 기록 열기
세 가지 방법이 있습니다.
- 사이드바의 “의도” 제목 위에 마우스를 올리고 기록 버튼을 클릭합니다.
- 보기 → 문서 기록을 선택하거나
⌘Y(Windows와 Linux에서는Ctrl+Y)를 누릅니다. - “이전 텍스트에 대한 설명입니다”라고 적힌 메모에서 “문서 기록에서 보기”를 클릭합니다.
앞의 두 가지는 사이드바만 전환하고 최신 버전을 선택하며, 메인 영역은 그대로 둡니다. 세 번째는 이 문서를 바꾼 가장 최신 버전을 선택하고, 현재 문서를 그 버전의 문서로 그 자리에서 바꿉니다.
기록을 보는 동안에도 메인 영역의 탭, 나란히 배치한 창, 코드 패널, 채팅은 평소처럼 동작합니다. 사이드바 맨 위의 “문서 기록 나가기”를 클릭하면 일반 사이드바로 돌아가며, 기록 탭도 함께 닫힙니다.
버전은 어디서 오나
의도 문서의 변경 하나하나가 버전입니다. 출처별로 다음과 같습니다.
| 출처 | 목록에서의 제목 |
|---|---|
| 제안을 수락함 | 제안의 제목. 예: “유예 기간이 시작되면 팀 소유자에게 이메일 보내기” |
| 정리안을 수락함 | 정리안 |
| Noea에서 저장했거나, Noea 밖에서 파일을 바꿈 | 직접 수정. 연속된 직접 수정은 다음 Explain이 끝날 때까지 하나의 버전으로 합쳐집니다 |
| 바뀐 모든 문서가 이미 기록된 상태로 돌아감 | “그 버전의 제목”(으)로 돌아감 |
| 기록을 시작했을 때의 문서 | 기록 시작 |
버전 목록 읽기
기록 화면에서는 사이드바 아래쪽이 버전 목록이 되어, 날짜별로 묶이고 최신이 위에 옵니다. 버전마다 두 줄을 차지합니다. 제목 다음 줄에 시간, 상태 아이콘, 출처 아이콘, 바뀐 문서 수(예: “문서 2개”)가 나옵니다.
- 시간: 직접 수정 버전은 첫 편집부터 마지막 편집까지의 구간을 보여 주며, 닫힐 때까지 “진행 중”으로 표시됩니다.
- 상태: 설명됨, 조사 중, 아직 설명 없음 중 하나로, 이 버전의 글에 설명이 있는지를 나타냅니다. 가리키면 어느 쪽인지 보입니다.
- 출처: 당신의 편집과 Agent의 편집을 구분합니다. 이전 버전으로 되돌아간 것에는 별도의 아이콘이 있습니다.
사이드바 위쪽은 여전히 중첩되고 펼쳐진 상태 그대로의 문서 트리입니다. 선택한 버전이 바꾼 문서에는 표시가 붙습니다.
| 변경 | 표시 |
|---|---|
| 생성됨 | 이름 옆의 초록색 점 |
| 수정됨 | 이름 옆의 노란색 점 |
| 삭제됨 | 마지막 위치에 나열되며 빨간색 취소선과 함께 흐리게 표시 |
| 이름 변경됨 | 새 이름 옆에 이전 이름이 희미하게 표시 |
그때의 문서 열기
버전을 선택하고 트리에서 문서를 클릭하면, 메인 영역에 그 버전 당시의 문서가 열립니다. 기록 속 문서는 읽기 전용이며, 제목 옆의 자물쇠에 마우스를 올리면 어느 버전인지 알려 줍니다. 레이아웃, 개요, 찾기, 메모는 평소처럼 동작하고, 글을 선택해 복사할 수 있습니다.
문서에는 이 버전이 이전 버전에서 무엇을 바꿨는지가 검토 모드 방식으로 표시됩니다. 추가, 다시 씀, 삭제가 표시되고, 삭제된 단락은 그 자리에 남아 있습니다. 아래쪽에서 차례로 이동할 수 있습니다.
이 버전이 문서를 바꾸지 않았다면, 그 이전의 마지막 변경 시점의 내용과 그 시점이 표시됩니다. 이 버전에서 문서가 아직 없었거나 이 버전이 삭제했다면 그 사실도 알려 줍니다.
다른 버전을 선택하면 열려 있는 기록 문서도 따라가서, 같은 문서를 그 버전 당시의 모습으로 보여 줍니다. 창에는 한 번에 기록 탭 하나만 있습니다.
그때의 설명 보기
기록 문서의 각 단락은 그 버전의 글에 대한 설명을 보여 줍니다. 단락이 나중에 다시 쓰였거나 삭제되었다면 메모는 “이 버전의 글에 대한 설명입니다”로 시작합니다. 지금의 문서가 아니라 그때의 글을 설명한다는 뜻입니다. 이 버전에서 아직 설명되지 않은 단락은 아직 설명 없음으로, 조사 중인 단락은 조사 중으로 표시됩니다.
그래서 “그때는 왜 그렇게 구현했지?”에 답할 수 있습니다. 예를 들어 3주 전 유예 기간 제안을 수락했을 때 그 설명에는 7일을 168시간으로 세는 선택이 나열되어 있었고, 팀의 시간대 기준 달력 날짜로 바뀐 것은 그 뒤의 일입니다.
이전 버전을 되찾고 싶을 때
문서 기록은 되돌아보기 위한 것이며 “이 버전으로 복원”은 없습니다. 되찾으려면 기록 문서에서 글을 복사해 현재 문서에 붙여넣고 저장하세요. 또는 채팅에서 Agent에게 단락을 예전 표현으로 되돌리는 제안을 초안으로 쓰게 하고, 검토한 뒤 수락하세요.
의도 폴더를 Git으로 관리한다면 Git으로 파일을 복원할 수도 있습니다. 모든 문서가 기록된 상태로 돌아가면 버전 목록에 “…”(으)로 돌아감 제목의 항목이 나타납니다.