자동 관리되는 공유 설치 안내문을 떠올려 보자. 상단에는 오늘 갱신했다고 적혀 있고 명령어도 그대로다. 새로 설치하려는 독자는 오늘도 이 명령어가 통하는지 확인한 문서로 받아들일 수 있다. 그런데 자동 작업이 한 일은 원문과 사본을 비교한 것뿐이다. 글이 같은지는 살폈지만 설치는 해 보지 않았다.

여기서 날짜를 새로 쓰면 문서가 낡았다는 신호만 사라진다. 명령어가 실제로 실패한다고 단정할 수는 없다. 반대로 오늘 날짜를 붙였다고 성공 근거가 생기지도 않는다. 독자가 알고 싶은 것은 최근에 파일을 열었는지가 아니라 지금 설치할 때 이 안내를 어디까지 믿어도 되는지다.

변경이 없을 때마다 표현을 조금씩 고치는 방식도 권하지 않는다. 그 수정까지 내용 변경으로 알린다면 독자는 달라진 조건이나 명령어를 찾으려고 문서를 다시 읽게 된다. 문장만 다듬은 수정이라면 그렇게 표시하면 된다. 매주 실행하는 작업이라고 해서 매주 안내 내용까지 바꿀 이유는 없다.

표시는 자동 작업이 확인한 범위에 맞추면 된다. 원문과의 차이만 검사했다면 ‘원문과 차이 없음’이라고 쓰고, 특정 운영체제와 프로그램 버전에서 설치까지 해 봤다면 그 조건과 결과를 남긴다. ‘재검토’라고만 쓰면 비교 검사와 실제 실행을 구별하기 어렵다.

본문이 그대로여도 설치를 다시 해 본 결과는 새 정보일 수 있다. 이때는 본문 수정일을 오늘로 덮기보다 재검토한 날짜와 확인한 조건을 붙이는 편이 정확하다. 내용이 바뀐 날과 작동을 확인한 날은 서로 다를 수 있다.

비교할 원문을 못 읽었다면 ‘변경 없음’조차 판정하지 못한 상태다. 마지막으로 확인한 날짜를 유지하고 이번 확인 실패를 따로 남겨야 한다. 실행 시간이 됐다는 사실을 재검토 완료로 바꾸면 날짜를 나눠 놓아도 소용없다.

수정일이 자동으로 찍히는 문서라면 위쪽에 짧은 검토 메모를 둘 수도 있다. 예를 들어 ‘본문 변경 없음. 오늘 원문과 대조함. 설치 실행은 확인하지 않음’이라고 적는 방식이다. 설치할 독자에게 필요한 구분은 이 정도로도 드러난다. 오늘 날짜는 남기되, 오늘 설치해 봤다는 뜻까지 맡기지는 말자는 제안이다.

2026/11/11 10:27 2026/11/11 10:27