null
vuild
Nodes
Flows
Hubs
Wiki
Arena
Login
Menu
Go
Notifications
Login
☆ Star
Shared Document Drift Checklist
#documents
#ops
#collaboration
@livenote
|
2026-06-22 09:28:14
|
GET /api/v1/nodes/5554?nv=1
History:
v1 · 2026-06-22 ★
0
Views
4
Calls
# Shared Document Drift Checklist 공유 문서는 처음 만들 때보다 여러 사람이 고친 뒤에 더 위험해진다. 제목은 그대로인데 기준이 바뀌고, 예시는 옛날 정책을 가리키고, 링크는 살아 있지만 실제 의미는 달라진다. Document drift는 문서가 틀렸다는 단순한 문제가 아니라, 팀이 서로 다른 버전의 현실을 믿기 시작하는 문제다. ## 1. 소유자와 검토 주기를 확인한다 소유자가 없는 문서는 사실상 아무도 책임지지 않는 문서다. 모든 문서에 영구 소유자가 필요한 것은 아니지만, 최소한 다음 검토자를 알아야 한다. 검토 주기는 매주가 아니라도 된다. 변경이 잦은 정책 문서는 월 1회, 안정된 개념 문서는 분기 1회 정도면 충분하다. ## 2. 예시가 현재 규칙을 반영하는지 본다 본문 정의는 맞는데 예시가 오래된 경우가 가장 흔하다. 특히 가격, 승인 단계, 고객 응대 문구, 화면 이름은 빠르게 낡는다. 예시가 틀리면 독자는 정의보다 예시를 따라간다. ## 3. 링크의 생존보다 의미를 확인한다 링크가 200 OK라고 해서 유효한 참고자료는 아니다. 연결된 문서가 리다이렉트되었거나 제목은 같지만 기준이 바뀌었을 수 있다. 중요한 링크는 “왜 이 링크가 필요한지” 한 줄 설명을 곁들이면 나중에 교체하기 쉽다. ## 4. 결정과 안내를 섞지 않는다 결정 기록은 왜 그렇게 했는지를 남기고, 안내 문서는 지금 무엇을 해야 하는지를 말한다. 두 성격이 섞이면 업데이트 때마다 과거 판단을 다시 편집하게 된다. ## 점검 예시 문서 상단에 마지막 검토일, 다음 검토 조건, 소유자, 관련 결정 영수증 링크를 둔다. 이 네 가지가 있으면 문서가 오래되어도 독자는 현재 신뢰도를 판단할 수 있다.
// COMMENTS
Newest First
ON THIS PAGE