릴리스 노트 양식

템플릿 소개

사용자에게 그대로 나가는 문서라 결재란이 없습니다

이 양식에는 확인 및 승인 표가 들어 있지 않습니다. 릴리스 노트는 사내 결재 문서가 아니라 배포와 함께 사용자에게 공개되는 글이기 때문입니다. 사내 배포 승인을 함께 받아야 한다면 문서 맨 아래에 3열 표를 하나 만들어 붙이되, 공개용 파일에서는 그 표를 지우고 내보내십시오. 구성은 제목 위 라벨(릴리스 노트) → 제목 → 회색 한 줄 → 문서정보표 → 번호 절 세 개 → 핵심 지표 표이고, 한 판본이 A4 두 장을 넘기지 않도록 잡혀 있습니다.

쓰는 차례

1. 문서정보표 네 칸을 채웁니다. 기본값은 버전 v2.7.0, 배포 일자 2026-06-11, 배포 대상 웹 · 모바일 전체, 릴리스 담당 플랫폼개발팀입니다. 단계 배포라면 배포 대상 칸에 대상 비율이나 그룹을 적습니다.
2. 제목 아래 회색 한 줄을 이번 판을 한 문장으로 요약한 문구로 덮어씁니다.
3. 1. 이번 릴리스 요약 → 2. 변경 내역 → 3. 호환성과 알려진 문제 순으로 씁니다.
4. 핵심 지표 표의 네 칸을 이번 판의 숫자로 바꿉니다.

세 절에 들어갈 내용

• 1. 이번 릴리스 요약 — 버전과 배포 시각, 예상 중단 시간, 반드시 확인해야 할 변경 한 가지, 영향을 받는 사용자 범위를 적습니다. 읽는 사람이 지금 무엇을 해야 하는지가 첫 문단에 없으면 나머지는 읽히지 않습니다.
• 2. 변경 내역 — 신규·개선·수정을 섞지 말고 나눠 적습니다. 신규 기능은 쓰는 방법 한 줄을 붙이고, 개선은 무엇이 어떻게 달라졌는지를 적고, 수정은 증상 기준으로 적으면서 이슈 번호를 병기합니다. 내부 리팩터링처럼 사용자가 체감하지 못하는 변경은 여기 넣지 않습니다.
• 3. 호환성과 알려진 문제 — 지원이 끝나는 항목과 대체 방법, 데이터 이관이나 설정 변경이 필요한지, 미해결 문제의 우회 방법과 롤백 절차를 적습니다. 알려진 문제를 숨긴 릴리스 노트는 문의를 줄이지 못하고 늘립니다.

핵심 지표 네 칸

핵심 지표 표에는 이번 버전 v2.7.0, 신규·개선 14건, 버그 수정 23건, 서비스 중단 0분이 들어 있습니다. 윗줄이 값, 아랫줄이 라벨인 2행 4열 표입니다. 건수는 변경 내역에 실제로 적은 줄 수와 같아야 합니다. 세어 보지 않고 대략 적으면 바로 아래 목록과 어긋나는 것이 눈에 띕니다. 서비스 중단 0분은 무중단 배포일 때만 쓰고, 점검 시간이 있었다면 실제 분 수를 적으십시오. 이번 판에서 특별히 알릴 값이 없으면 라벨을 지원 종료 항목이나 최소 지원 버전처럼 바꿔 쓰는 편이 낫습니다.

다음 판을 위해 남길 것

4절과 5절에 해당하는 내용은 파일에 인쇄되지 않지만 실무에서는 함께 정해 둡니다. 단계별 배포 비율과 관찰 지표, 중단이 필요하면 공지 시점과 채널, 롤백 판단 기준과 결정 권한이 그것입니다. 롤백 기준은 배포 전에 정해야 합니다. 장애가 난 뒤에 정하면 되돌릴 시점을 놓칩니다. 장애 접수 창구와 대응 시간, 다음 릴리스 예정일, 이번 판에서 미룬 항목은 사용자 문의를 줄이는 항목이므로 공개본 맨 끝에 짧게 붙이는 것을 권합니다.

표와 서식은 이렇게 동작합니다

워드 문서라 건수 합계가 자동으로 계산되지 않습니다. 핵심 지표 표는 윗줄이 값, 아랫줄이 라벨인 2행 4열 구조이고 문서정보표는 1행 4열입니다. 변경 내역이 길어지면 2절의 불릿을 늘리기보다 신규 · 개선 · 수정 세 덩어리로 소제목을 나누고 각각 목록을 붙이는 편이 읽기 좋습니다. 이때도 각 목록의 줄 수를 세어 핵심 지표 표의 14건 · 23건과 맞춰야 합니다. 사내 승인용 표를 붙일 때는 문서 맨 아래에 3열 표를 만들고 아래 행 높이를 서명 공간만큼 남기십시오. 공개할 때는 그 표와 내부용 각주를 지운 사본을 따로 내보내는 것이 안전합니다.

내보내기 전 점검

• 버전 표기가 문서정보표와 핵심 지표 표에서 다른 것. 두 곳 모두 v2.7.0으로 되어 있습니다.
• 내부 코드명이나 담당자 이름이 그대로 남는 것. 공개본입니다.
• 이슈 번호만 적고 증상을 적지 않는 것. 사용자는 번호로 검색하지 않습니다.
• 롤백 절차를 적지 않는 것. 3절의 마지막 항목이 그 자리입니다.
• 배포 일자만 적고 배포 시각을 적지 않는 것. 사용자는 언제부터 달라졌는지로 문의합니다.