전체 활용 사례

지원 질문에서 문서 자동 업데이트

같은 지원 질문이 세 번 나타나면, Zero가 문서 업데이트 초안을 작성하고 PR을 등록해, 다음 사람이 묻기 전에 답을 찾게 합니다.

Zero가 연결합니다:SlackGitHubNotion

Zero가 제공하는 것

무엇이 문제인가

모든 지원 채널에는 절대 사라지지 않는 질문이 대여섯 개씩 있습니다. 제품이 헷갈려서가 아니라, 문서에 그 내용이 없어서입니다. 그런 스레드를 수동으로 추적하고, 업데이트 초안을 작성하고, PR을 올리는 일은 늘 뒷전으로 밀리는 종류의 작업입니다. Docs Auto-Update는 지원 채널을 지켜보며 반복되는 질문을 세고, 어떤 질문이 서로 다른 사람들에게 세 번 이상 물어진 순간 문서 업데이트 초안을 작성하고 PR을 등록합니다. 리뷰어는 2분 동안 승인하면 됩니다. 같은 질문을 가진 다음 사람은 묻는 대신 답을 찾습니다.

Zero가 해결하는 방법

1단계: 도구 연결하기

Slack
Slack
필수
Slack. Zero가 반복 질문을 감지하기 위해 지원 채널을 읽습니다. 지정한 채널에 대한 읽기 권한이 필요합니다.
연결
GitHub
GitHub
필수
GitHub. Zero가 문서 업데이트를 웹사이트 저장소에 PR로 작성합니다. Zero가 브랜치를 만들고 PR을 열 수 있도록 저장소 쓰기 권한이 필요합니다.
연결
Notion
Notion
선택
Notion. 선택 사항. 내부 문서가 Notion에 있고 Zero가 그것도 업데이트하길 원할 때 유용합니다.
연결

2단계: Zero에게 요청하기

@Zero 매주 #support와 #community에서 지난 14일 동안 서로 다른 사람 3명 이상이 물어본 질문을 스캔해줘. 각각에 대해 문서 업데이트 초안을 작성하고 그 변경 사항을 담은 PR을 웹사이트 저장소에 열어줘.
Zero가 반복 질문을 찾기 위해 지원 채널을 지켜봅니다
Zero가 들어오는 지원 스레드를 읽고, 유사한 질문을 의미 기반으로 군집화하고, 고유 질문자를 셉니다. 일정 기간 동안 서로 다른 사용자 3명 이상에게서 나온 질문은 문서 빈틈으로 표시됩니다.
Zero가 해결된 답변을 토대로 문서 업데이트 초안을 작성합니다
표시된 각 질문에 대해, Zero가 스레드의 해결 내용을 읽고, 알맞은 문서 위치(기존 섹션 또는 새 가이드)를 파악한 뒤, 구체적인 예시와 함께 사이트의 마크다운 형식으로 업데이트 초안을 작성합니다.
Zero가 검토용 PR을 등록합니다
각 초안이 웹사이트 저장소에 PR로 들어가며, 설명에는 이를 촉발한 질문 스레드가 링크됩니다. 문서 팀의 리뷰어가 승인하니, 여러분은 처음부터 작성하지 않아도 됩니다.

3단계: 한 걸음 더 나아가기

알맞은 리뷰어에게 라우팅
PR을 일반 리뷰어가 아니라 컴포넌트 담당자에게 할당하세요.
@Zero 결제 질문에 대한 문서를 작성할 때 PR에 @docs-team 대신 @billing-team을 태그해줘.
위험이 낮은 업데이트 자동 게시
오타 수정과 작은 명확화는 사람의 검토 없이 반영되게 하세요.
@Zero 기존 섹션만 건드리는 50줄 미만의 문서 PR은 CI가 통과하면 자동 병합을 활성화해줘.
커버리지 확장
신호를 위한 새 소스 채널을 추가하세요.
@Zero Slack뿐만 아니라 지원 Gmail 받은편지함도 반복 질문이 있는지 스캔해줘.

더 나은 결과를 위한 팁

'반복' 임계값을 1이 아니라 14일 동안 고유 질문자 3명으로 설정하세요. 1이면 매일 문서를 다시 쓰게 되고, 3이면 진짜 빈틈을 잡게 됩니다.
PR 설명에 항상 출처 스레드를 포함하세요. 리뷰어가 원래 질문을 보고 초안이 실제로 답하는지 판단할 수 있습니다.
해결된 스레드가 내부 지식 베이스로도 함께 흘러가도록 KB Capture와 함께 사용하세요.