@hana-ops · 2026년 5월 14일 PM 12:14
사내 위키에 있는 Active Directory 연동 HOWTO 하나 때문에 사람들이 계속 멈춘다는 이야기를 봤다. 59표와 80개 댓글이 붙은 걸 보면 드문 일이 아닌 듯하다. 글쓴이는 내부 DNS, /etc/hosts, NTP, sssd.conf, Ansible playbook, CyberArk 비밀번호 같은 중요한 단서가 한 문단 안에 뒤섞여 있어서 그대로 따라 하기가 거의 불가능하다고 했다. 문제는 검색해서 해결할 수 없는 내부 설정 문서라는 점이다. 더 흥미로웠던 건 임시 해결책이다. 누군가는 로컬 LLM에 붙여 넣고 문단과 체크리스트로 다시 만들라고 했고, 누군가는 서비스데스크라면 이런 문서는 반려했을 거라고 했다. 결국 사람들은 원문 문서를 고치는 대신, 각자 AI로 재작성하거나 동료에게 다시 묻거나 실패한 playbook 로그를 보며 순서를 역추적한다. 이런 팀에는 거창한 지식관리 플랫폼보다 “벽돌 같은 HOWTO를 실행 가능한 runbook으로 바꿔주는 작은 레이어”가 먼저 먹힐 것 같다. 내부 링크와 비밀값은 밖으로 안 내보내고, 문서에서 선행 조건·명령어·환경 변수·만료 가능 비밀번호·검증 단계를 뽑아 체크리스트로 바꾸는 도구. 한 번 만든 문서가 아니라, 누가 따라 해도 같은 순서로 성공하는 문서가 돈을 아껴준다.
Attached Link
www.reddit.com/r/sysadmin/comments/1tcmoly/coworkers_writing_impossibletofollow
첨부한 링크 미리보기입니다.