사람들이 실제로 읽어주는 릴리스 노트 작성법 (예시 포함)
대부분의 릴리스 노트는 읽히지 않으며, 그중 상당수는 애초에 존재해서는 안 됩니다.
릴리스 노트를 잘 작성하는 것은 문장력보다는 체계적인 접근 방식에 더 달려 있습니다. 1,139개 리포지토리의 1,529개 문제를 대상으로 한 Empirical Software Engineering 연구에 따르면, 릴리스 노트 작성의 실패 사례 대부분은 글쓰기 실력이 아니라 계획 및 자동화 과정의 미비에서 비롯된 것으로 나타났습니다.
팀들은 문체의 뉘앙스에 지나치게 신경 쓰지만, 사실 진짜 문제는 그보다 더 근본적인 곳에 있습니다. 바로 애초에 어떤 내용을 릴리스 노트에 포함시킬지 결정하는 것입니다.
이 가이드는 제품 관리자, 엔지니어링 리더, 그리고 사용자에게 변경 사항을 알리는 책임을 맡은 모든 분을 위한 것입니다. 여기서는 작성 과정, 형식, 배포 채널은 물론, 여러분이 게시한 내용을 실제로 누가 열어볼지 결정하는 편집상의 판단 기준까지 다룰 예정입니다.
요약
- 작성하기 전에 모든 변경 사항을 선별하세요: 공지할지, 포함시킬지, 아니면 생략할지 결정하세요. 대부분의 팀은 변경 사항을 지나치게 많이 공지합니다.
- 코드 변경 사항이 아니라 사용자에게 미치는 영향을 먼저 강조하세요. “검색 속도가 3배 빨라졌습니다”는 “Elasticsearch로 마이그레이션했습니다”보다 훨씬 효과적입니다.
- 배포 5분 전에 작성하지 말고, 일이 진행되는 동안 티켓 내에서 릴리스 노트를 작성하세요.
- 구체적인 배포 채널을 선정하고 그 채널을 책임지세요. 무분별한 배포는 그만두세요.
- 제목은 독자의 80%에게 있어 릴리스 노트의 전부입니다. 제목만으로도 충분히 의미를 전달할 수 있도록 하세요.
릴리스 노트란 무엇인가요?
릴리스 노트는 특정 소프트웨어 릴리스에서 어떤 기능이 추가되었는지, 어떤 문제가 수정되었는지, 그리고 어떤 부분이 변경되었는지 사용자에게 알려주는 문서, 페이지 또는 앱 내 메시지입니다. 릴리스 노트는 엔지니어링 팀의 일과 사용자의 경험 사이를 연결하는 가교 역할을 합니다.
릴리스 노트에는 일반적으로 새로운 기능, 개선 사항, 버그 수정, 알려진 문제점, 그리고 업데이트 후 사용자가 알아야 할 모든 내용이 포함됩니다.
닐슨 노먼 그룹(Nielsen Norman Group)의 ‘변화 맹점 ( change blindness )’에 대한 연구에 따르면, 그 값이 명백하고 명확하게 전달되지 않는 한 사용자들은 인터페이스 변경 사항을 종종 놓치는 것으로 나타났습니다. 단순히 기능을 출시하는 것만으로는 충분하지 않습니다. 그 기능이 왜 중요한지 설명해야 합니다.
릴리스 노트는 변경 내역(changelog)이나 패치 노트(patch notes)와는 다릅니다. 변경 내역은 여러 버전에 걸친 모든 제품 변경 사항을 기록한 연혁입니다. 릴리스 노트는 단일 소프트웨어 업데이트에 초점을 맞추며, 사용자가 가장 중요하게 생각하는 변경 사항을 강조합니다. 패치 노트는 일반적으로 범위가 더 좁으며 주로 버그 수정에 중점을 둡니다.
SaaS 팀의 경우, 릴리스 노트는 배포나 스프린트 업데이트를 사용자에게 전달하는 창구 역할을 합니다. 단순한 엔지니어링 티켓을 나열하는 대신, 릴리스가 실제 사용자에게 미치는 영향을 알기 쉬운 언어로 설명해 줍니다.
형식은 제품에 따라 다릅니다. 소프트웨어 릴리스 노트는 제품 사이트의 전용 페이지, 앱 내 모달 창, 이메일, 또는 앱 스토어의 업데이트 설명란에 게재될 수 있습니다.
제품 팀에게 훌륭한 릴리스 노트가 중요한 이유는 무엇일까요?
제품 릴리스 노트는 단순히 출시된 내용을 기록하는 것 이상의 역할을 합니다. 이는 제품이 어떻게 인식되고, 채택되며, 지원되는지에 직접적인 영향을 미칩니다.
- 기능 채택: 사용자는 존재조차 모르는 기능을 채택할 수 없습니다. 릴리스 노트는 이미 제품을 사용하고 있는 사용자에게 새로운 기능을 알리는 가장 쉬운 방법입니다.
- 지원 티켓 감소: 갑작스러운 UI 변경은 사용자를 혼란스럽게 합니다. 명확한 릴리스 노트는 예상된 업데이트로 인해 발생하는 “버그 신고”를 방지합니다.
- 신뢰와 투명성: 알려진 문제와 버그 수정 사항을 공개하는 것은 팀이 문제를 숨기지 않고 사용자의 의견을 경청하며 지속적으로 개선해 나가고 있음을 보여줍니다.
- 내부 협업: 엔지니어링, 지원, 영업 팀, 마케팅 팀 모두 어떤 기능이 출시되었는지, 그리고 그 이유가 무엇인지 파악해야 합니다. 릴리스 노트는 모든 팀이 동일한 정보를 공유할 수 있도록 도와줍니다.
- 피드백 신호: 반응(답글, 반응, 좋아요)을 유도하는 릴리스 노트는 제품 팀이 고객 감정을 파악할 수 있는 간편한 피드백 루프를 제공합니다.
릴리스 노트 선별: 모든 변경 사항이 릴리스 노트에 포함될 만한 것은 아닙니다
대부분의 팀은 모든 것을 발표하는 것을 기본으로 합니다. 그래서 그들의 릴리스 노트는 아무도 읽지 않게 되는 것입니다.
더 효율적인 방법은 글을 쓰기 전에 모든 변경 사항을 다음 세 가지 범주 중 하나로 분류하는 것입니다:
- 출시 및 공지: 변경 사항이 사용자 행동에 영향을 미치거나, 사용자의 기대를 저버리거나, 사용자의 조치가 필요한 경우. 릴리스 노트를 작성하세요. 이것이 바로 릴리스 노트의 목적입니다.
- Ship-and-embed: 변경 사항은 제품 자체에서 바로 확인할 수 있습니다. 새로운 버튼, 눈에 띄는 메뉴 항목, 툴팁 등이 그 예입니다. 제품 자체가 사용법을 알려줍니다. 이 경우 릴리스 노트는 생략해도 됩니다.
- Ship-and-bury: 인프라 마이그레이션, 리팩토링, 눈에 띄지 않는 성능 개선과 같이 내부적으로만 처리되는 일입니다. 고객 대상 노트가 아닌 엔지니어링 로그에 기록해야 합니다.
중요한 것은 더 나은 릴리스 노트를 작성하는 것이 아니라, 어떤 변경 사항에는 릴리스 노트가 필요 없는지 파악하는 것입니다. 간결하고 핵심만 담은 노트가 더 많이 읽힙니다. “12가지 사소한 개선 사항”을 담은 월간 요약본은 무시되기 마련입니다.
누가 릴리스 노트를 작성해야 할까요?
엔지니어링 팀은 코드를 배포하기 때문에 기본적으로 릴리스 노트를 작성하게 됩니다. 문제는 기술 팀이 자연스럽게 자신이 만든 것에 대해 설명할 뿐, 사용자가 얻은 이점에 대해서는 설명하지 않는다는 점입니다.
그 결과, 내부 전문 용어와 데이터베이스 마이그레이션, 엔드포인트 변경 사항에 대한 언급으로 가득 찬 노트가 만들어집니다. 이러한 내용은 일반 고객에게는 아무런 의미가 없습니다.
더 나은 모델은 공동 책임입니다. 제품 관리자나 제품 마케팅 관리자는 제품 전략과 고객 모두와 가장 밀접하게 연관되어 있으므로 최종 초안을 책임져야 합니다. 엔지니어링 팀은 풀 리퀘스트, 티켓, 스프린트 요약 등을 통해 원자료를 제공합니다. 지원팀과 고객 성공 팀은 노트의 명확성과 잠재적인 혼란 요소를 검토합니다.
소규모 팀의 경우, PR을 병합한 사람이 릴리스 노트를 작성하기도 합니다. 게시하기 전에 사용자의 관점에서 내용을 다시 작성한다면 문제될 것은 없습니다. 매주 또는 매일 릴리스를 진행하는 대규모 팀의 경우, 전담 릴리스 매니저나 코디네이터가 프로세스를 주도하여 원활하게 진행되도록 하는 경우가 많습니다.
또한 동일한 릴리스 노트를 두 가지 버전으로 작성하는 것도 일반적입니다. 내부용 릴리스 노트에는 데이터베이스 변경 사항, 인프라 업데이트 또는 API 세부 정보가 포함될 수 있습니다. 맞춤형 릴리스 노트는 사용자에게 미치는 영향과 쉬운 언어로 된 설명에만 초점을 맞춰야 합니다.
릴리스 노트에는 무엇이 포함되어야 할까요?
일관된 릴리스 노트 형식은 사용자가 필요한 정보를 쉽게 찾을 수 있게 해주고, 작성자가 어떤 내용을 다뤄야 할지 파악하는 데 도움이 됩니다. 다음은 모든 릴리스에 적용할 수 있는 체크리스트입니다:
- 버전 번호 또는 출시일: 릴리스 노트를 특정 시점에 고정하여 사용자와 지원팀이 나중에 참조할 수 있도록 합니다.
- 요약 제목: 가장 중요한 변경 사항을 쉬운 말로 한 문장으로 요약한 것
- 새로운 기능: 어떤 기능이 추가되었는지, 사용자가 이제 무엇을 할 수 있게 되었는지를 중심으로 설명합니다.
- 개선 사항: 성능, 사용자 경험(UX) 또는 워크플로우 변경을 포함한 기존 기능의 개선 사항
- 버그 수정: 어떤 문제가 있었는지, 그리고 사용자가 이제 무엇을 기대할 수 있는지, 과장된 표현 없이 설명하기
- 알려진 문제: 팀이 인지하고 있지만 아직 해결하지 못한 모든 사항입니다. 이를 포함하면 신뢰도를 높일 수 있습니다.
- 사용 중단 또는 호환성 변경 사항: 사용자의 조치가 필요한 방식으로 제거되거나 변경된 모든 사항
- 기술 문서 링크: 주요 변경 사항에 대한 더 자세한 내용을 확인하려면 독자를 도움말 문서나 가이드로 안내하세요.
모든 릴리스에 이 모든 항목이 포함되는 것은 아닙니다. 사소한 패치의 경우 버그 수정 사항과 버전 번호만 포함될 수도 있습니다. 이 체크리스트를 최소 기준이 아닌, 최대 기준으로 생각하십시오.
제품 리더인 슈레야스 도시(Shreyas Doshi)는 LNO 프레임워크를 널리 알렸습니다. 이 프레임워크는 제품 팀이 단순한 행정 업무에 불과한 ‘오버헤드(Overhead)’ 작업 대신, 10배의 효과를 내는 ‘레버리지(Leverage)’ 작업을 식별하도록 권장합니다. 너무 많은 기업이 릴리스 노트를 사용자에게 새로운 가치를 홍보할 수 있는 ‘레버리지’ 기회로 여기기보다는, 그저 체크리스트에서 지워야 할 지루한 ‘오버헤드’ 작업으로 취급하고 있습니다.
릴리스 노트 작성 방법: 단계별 절차
훌륭한 릴리스 노트는 한 가지 역할을 확실히 수행합니다. 바로 사용자가 무엇이 변경되었는지, 그 변경 사항이 왜 중요한지, 그리고 다음에 무엇을 해야 하는지 이해할 수 있도록 돕는 것입니다. 대부분의 팀이 저지르는 실수는 릴리스 노트를 배포 5분 전에 급하게 작성하는, 사후 고려 사항으로 취급하는 것입니다.
더 나은 프로세스는 훨씬 더 일찍부터 시작됩니다. 다음은 전문가들이 검증한 릴리스 노트 작성 방법입니다.
1단계: 릴리스 노트의 대상 독자 결정하기
글을 쓰기 전에, 주요 대상 독자가 누구인지 먼저 결정하세요. 일반적으로 릴리스 노트는 다음 그룹 중 하나 이상을 목표로 합니다:
- 최종 사용자
- 관리자 또는 IT 팀
- 개발자 및 API 사용자
- 지원, 영업 팀, 고객 성공과 같은 내부 팀
이 단계는 대부분의 팀이 생각하는 것보다 훨씬 중요합니다. 릴리스 노트에 기술 용어, 마케팅 용어, 설정 안내가 뒤섞여 있다면, 대부분의 사람들은 읽기를 중단할 것입니다.
다음과 같은 간단한 규칙을 따르세요:
- 변경 사항의 영향을 받는 사용자를 위해 작성하세요
- 먼저 변경 사항이 미치는 영향을 설명하세요
- 기술적 세부 사항은 꼭 필요한 경우에만 추가하세요
글쓰기가 서툴러도 걱정하지 마세요. 요즘 대부분의 프로젝트 관리 도구에는 초안을 쉽게 작성할 수 있도록 도와주는 AI 기능이 탑재되어 있습니다.
2단계: 릴리스 주기 전반에 걸쳐 업데이트 사항 수집하기
릴리스 노트를 작성하기에 최악의 시기는 배포 직전입니다. 이때는 팀원들이 중요한 수정 사항을 잊어버리거나, 예외적인 사례를 빠뜨리거나, 더 이상 전체적인 맥락을 기억하는 사람이 없어 모호한 요약만 작성하게 되기 때문입니다.
좋은 릴리스 노트는 개발 과정 중에 지속적으로 작성되는 것입니다. 개발이 끝난 후에 작성하는 것이 아닙니다.
가장 쉬운 방법은 작업이 진행되는 동안 티켓, 풀 리퀘스트 또는 작업 업데이트 내에 릴리스 노트에 바로 활용할 수 있는 요약 내용을 기록해 두는 것입니다. 일부 팀은 모든 티켓에 “릴리스 노트” 필드를 필수 항목으로 지정하기도 합니다.
다음과 같은 간단한 습관이 도움이 됩니다:
- 티켓이 생성될 때 사용자를 위한 요약문을 작성하세요
- 범위가 변경되면 내용을 업데이트하세요
- 나중에 릴리스 노트에서 해당 문구를 재사용하세요
현재 많은 팀이 티켓과 병합된 풀 리퀘스트를 바탕으로 릴리스 노트 초안을 직접 작성하고 있습니다.
r/SaaS 커뮤니티의 한 레딧 사용자로부터 배운 내용은 다음과 같습니다.
처음부터 사용자 친화적인 언어로 기능 티켓을 작성하세요. 티켓에 사용자에게 미치는 영향이 이미 명확하게 설명되어 있다면, 병합된 작업 항목을 바탕으로 릴리스 노트를 생성하는 과정이 훨씬 간단해지고 자동화하기도 쉬워집니다.
이는 정확도 향상에도 도움이 됩니다. 대부분의 제품 변경 사항은 고객 요청에서 시작되므로, 원래의 티켓에는 대개 문제와 수정 사항의 값에 대한 가장 명확한 설명이 담겨 있습니다.
티켓이 지원 포털과 연결되어 있다면, 업데이트가 적용되는 즉시 해당 기능을 요청한 사용자에게 알림을 보낼 수도 있습니다.
목표는 간단합니다. 릴리스 노트 생성을 막판에 급하게 처리하는 일이 아니라, 워크플로우의 일부로 만드는 것입니다.
3단계: 변경 사항을 명확한 범주로 분류하기
대부분의 사용자는 릴리스 노트를 처음부터 끝까지 꼼꼼히 읽지 않고 대충 훑어봅니다. 업데이트 내용이 하나의 긴 텍스트 블록으로 표시되면 독자들은 중요한 변경 사항을 놓치게 됩니다. 명확한 카테고리 구분을 통해 이 문제를 해결할 수 있습니다.
릴리스 노트에 포함할 모든 자료를 수집했다면, 이를 큰 주제별로 분류하세요. 릴리스 노트에서 흔히 사용되는 분류 항목은 다음과 같습니다:
- 새로운 기능
- 개선 사항
- 버그 수정
- 보안 업데이트
- API 변경 사항
- 연동 기능
- 알려진 문제
- 사용 중단된 기능
예를 들어, 대시보드 필터의 로딩 속도가 빨라졌다면 이를 ‘개선 사항’ 항목에 포함시키세요. 반복 청구서 알림을 예약할 수 있는 기능을 출시했다면, 이를 ‘새로운 기능’ 항목으로 분류하세요.
이를 통해 독자들은 자신에게 중요한 내용을 빠르게 찾을 수 있습니다. 또한 팀 간 혼란을 줄일 수 있습니다. 지원팀은 문제 해결에 집중할 수 있고, 개발자는 API 변경 사항을 검토할 수 있으며, 고객은 새로운 기능을 확인할 수 있습니다.
여기서 몇 가지 실용적인 팁을 알려드립니다:
- 가장 중요한 업데이트를 맨 앞에 배치하세요
- 릴리스 간에 카테고리 이름을 일관되게 유지하세요
- 밀집된 문단 대신 글머리 기호를 사용하세요
- 관련 없는 업데이트를 한데 묶지 마세요
- 대규모 릴리스의 경우, 맨 위에 가장 중요한 업데이트 한두 가지를 간략히 정리한 ‘TL;DR’ 섹션을 추가하세요.
변경 사항을 제품 영역(예: “대시보드”, “모바일”, “API”)별로 태그를 지정하면 두 번째 탐색 계층이 추가되어, 사용자가 관심 있는 제품 부분으로 바로 이동할 수 있습니다. 이는 다양한 사용자 유형이 있는 플랫폼 제품에서 특히 유용합니다.
4단계: 사용자가 반드시 수행해야 할 사항을 명확하게 설명하세요
지침 하나만 빠뜨려도 수백 건의 지원 티켓이 발생할 수 있습니다. 그렇기 때문에 릴리스 노트에는 조치 항목에 대한 별도의 섹션을 마련해야 합니다.
사용자가 무언가를 변경해야 할 경우, 이를 명확하고 조기에 알려주세요. 문단 속에 묻어두지 마세요.
여기에는 다음과 같은 내용이 포함됩니다:
- 필수 마이그레이션
- 비밀번호 재설정
- 권한 변경 사항
- API 사용 중단
- 새로운 구성 요구 사항
- 예정된 서비스 중단
- 청구 관련 업데이트
| 쓰지 말아야 할 내용 | 대신 무엇을 써야 할까요? |
|---|---|
| HubSpot 연동 기능에 대한 인증 업데이트가 적용되었습니다. | HubSpot 연동 기능의 인증 절차가 업데이트되었습니다. 연결 오류가 발생하지 않도록 관리자는 6월 1일 이전에 HubSpot 연동 기능을 재승인해야 합니다. |
| 레거시 인증 방식 지원이 제거되었습니다 | 레거시 인증 방식에 대한 지원을 중단했습니다. 이 방식을 사용하는 애플리케이션은 OAuth 2.0으로 업그레이드하지 않는 한 7월 15일 이후부터 작동하지 않게 됩니다. |
다음은 사용자가 무엇을 해야 하는지 누구도 의문을 품지 않게 하는 Salesforce의 릴리스 노트 예시입니다.

5단계: 자세한 문서로 연결하기
릴리스 노트는 변경 사항을 설명해야 합니다. 제품 설명서 전체를 담는 자료가 되어서는 안 됩니다.
릴리스 노트에 모든 예외적인 경우, 설정 단계, 워크플로우를 설명하려고 하면 두 가지 문제가 발생합니다:
- 문서가 너무 길어집니다
- 중요한 업데이트를 파악하기가 점점 더 어려워지고 있습니다
대신, 릴리스 노트를 안내 형식의 요약문처럼 작성하세요. 독자들에게 먼저 키 업데이트 내용을 전달하고, 더 자세한 내용을 알고 싶다면 관련 문서로 연결되는 링크를 제공하세요.
도움말 문서, 변경 내역, API 문서, 비디오 튜토리얼 및 기타 관련 콘텐츠로 링크를 연결할 수 있습니다. 예시:
” SAML 기반 싱글 사인온(SSO) 지원이 추가되었습니다. 이 비디오를 통해 작업 공간에 SSO를 설정하는 방법을 확인해 보세요. ”
” SAML 기반 싱글 사인온(SSO) 지원이 추가되었습니다. 이 비디오를 통해 작업 공간에 SSO를 구성하는 방법을 확인해 보세요. ”
이 접근 방식이 효과적인 이유는 사용자마다 필요한 정보의 세부 수준이 다르기 때문입니다. 제품 관리자는 요약본만 필요할 수 있지만, 기능을 설정하는 관리자는 20단계에 걸친 구성 가이드가 필요할 수도 있습니다.
6단계: 팀 간 릴리스 노트 검토
단일 팀이 작성한 릴리스 노트에는 대개 중요한 내용이 빠져 있는 경우가 많습니다.
엔지니어링 팀은 구현 세부 사항에 지나치게 집중할 수 있습니다. 마케팅 팀은 변경 사항을 과대 포장할 수 있습니다. 제품 팀은 예외적인 경우를 간과할 수 있습니다. 지원팀은 혼란스러운 표현을 즉시 포착할 수 있습니다.
바로 그 때문에 훌륭한 릴리스 노트는 공개 전에 여러 부서의 검토를 거칩니다.
최소한 제품, 엔지니어링, 고객 지원 부서의 담당자를 참여시키세요. 가능하다면 기술 문서 작성자나 문서 관리자도 포함시키세요.
각 검토자에게 간단한 체크리스트를 제공하세요:
- 출시일은 정확한가요?
- 표현이 명확한가요?
- 오해의 소지가 있는 내용이 있나요?
- 실행 항목의 가시성이 유지되고 있나요?
- 링크가 맞나요?
- 알려진 문제들이 문서화되어 있나요?
7단계: 사용자가 실제로 볼 수 있는 곳에 릴리스 노트를 게시하세요
아무리 훌륭한 릴리스 노트라도 아무도 읽지 않으면 소용이 없습니다. 흔히 저지르는 실수 중 하나는 사용자가 절대 방문하지 않는, 잊혀진 변경 내역 페이지에 업데이트 내용을 숨겨두는 것입니다.
대신, 대상 독자들이 이미 이용하고 있는 채널을 통해 릴리스 노트를 배포하세요. 여기에는 다음이 포함될 수 있습니다:
- 앱 내 알림
- 이메일 업데이트
- 제품 블로그
- 헬프 센터
- 개발자 포털
- 커뮤니티 포럼
- GitHub 변경 내역
적절한 전달 채널은 릴리스의 유형과 그 영향에 따라 달라집니다. 예시: 주요 변경 사항의 경우 이메일 및 앱 내 공지사항으로 알리는 것이 적절하지만, 사소한 수정 사항의 경우에는 그럴 필요가 없습니다.
시기도 중요합니다. 사용자가 마감일 전에 조치를 취해야 하는 경우, 사용자가 대응할 수 있도록 충분히 일찍 릴리스 노트를 게시하세요.
효과적인 릴리스 노트를 처음부터 끝까지 작성하는 실제 과정을 보여주는 짧은 비디오를 소개합니다.
실제로 도움이 되는 릴리스 노트 작성 최고의 실행 방식
다음 팁을 따라 릴리스 노트를 쉽게 작성하면서도 사용자에게 실질적인 도움이 되도록 해보세요.
재사용 가능한 템플릿부터 시작하세요
템플릿을 사용하면 릴리스 노트 작성에서 가장 어려운 부분인 ‘빈 페이지에서 시작하는 일’을 해결할 수 있습니다. 또한 매 릴리스마다 일관성을 유지할 수 있어, 매주 또는 매일 릴리스를 진행하는 팀에게 특히 중요합니다.
간단한 릴리스 노트 템플릿에는 다음 내용이 포함되어야 합니다:
- 피드백 섹션
- 버전 번호 또는 출시일
- 새로운 기능
- 개선 사항
- 버그 수정
- 알려진 문제
템플릿은 팀이 이미 일하고 있는 곳에 저장하세요. wiki, 문서화 도구, 프로젝트 관리 작업 공간 등이 될 수 있습니다. 접근이 쉬울수록 팀원들이 꾸준히 사용할 가능성이 높아집니다.
많은 프로젝트 관리 도구에는 연결된 작업과 버전 세부 정보를 자동으로 불러오는 릴리스 노트 템플릿이 포함되어 있어, 릴리스 주간에 수작업 부담을 줄여줍니다.
예를 들어, ClickUp의 릴리스 노트 템플릿을 사용하면 각 제품 릴리스 시 중요한 변경 사항을 정리하고 공유할 수 있습니다. 다음을 수행할 수 있습니다:
- 각 릴리스의 진행 상황을 추적할 수 있도록 다양한 맞춤형 상태를 적용한 작업을 생성하세요
- 사용자 지정 필드를 활용해 릴리스 노트와 기능 요청을 분류하고 속성을 추가하여 관리하세요
- 댓글 반응, 중첩된 하위 작업, 여러 담당자 지정, 우선순위 기능을 활용하여 릴리스 추적 기능을 개선하세요
- ClickUp Brain의 통합 AI 라이터를 활용하여 글의 완성도를 높여보세요
코드 변경 사항이 아닌, 사용자에게 미치는 영향을 먼저 제시하세요
이것이 바로 대부분의 팀이 저지르는 가장 큰 실수입니다.
사용자들은 귀사의 팀이 서비스를 마이그레이션했는지, 프레임워크를 업데이트했는지, 데이터베이스 인덱스를 최적화했는지는 신경 쓰지 않습니다. 사용자들이 관심 있는 것은 자신들에게 어떤 변화가 있었는지입니다.
동일한 변경 사항에 대한 다음 두 버전을 비교해 보세요:
| 쓰지 말아야 할 내용 | 대신 무엇을 작성해야 할까요? |
|---|---|
| 레거시 엔드포인트 사용 중단 | 이전 API 버전(v1)을 제거했습니다. [날짜]까지 v2로 마이그레이션해 주세요. |
| 알림 서비스의 경합 조건을 해결했습니다 | 때때로 알림이 중복되어 표시되던 버그를 수정했습니다. |
| OAuth 2.0 PKCE 흐름 구현 | 모바일 앱을 위한 더욱 안전한 로그인 방식을 추가했습니다. |
| 쿼리 성능 향상을 위해 검색 인덱스를 Elasticsearch로 마이그레이션했습니다. | 이제 모든 플랜에서 검색 결과가 최대 3배 더 빠르게 로드됩니다. |
| 역할 기반 접근 제어(RBAC)를 지원하도록 권한 모듈을 리팩토링했습니다. | 이제 맞춤형 역할을 할당하여 작업 공간 내에서 누가 어떤 내용을 볼 수 있는지 제어할 수 있습니다. |
여기에는 간단한 원칙이 있습니다. 릴리스 노트에 대부분의 사용자가 들어본 적도 없는 기술 용어가 포함되어 있다면, 내용을 다시 작성하세요. 여러분의 임무는 “우리가 무엇을 만들었는지”를 “사용자가 무엇을 얻게 되는지”로 전달하는 것입니다.
난해한 전문 용어는 피하고 쉬운 말로 작성하세요
좋은 릴리스 노트는 깊이 있게 읽기 위한 것이 아니라 훑어보기 위해 작성되기 때문에 간결하게 느껴집니다.
독자가 기술 분야에 매우 정통한 경우가 아니라면 약어는 피하세요. 용어가 처음 등장할 때는 풀어서 적어 주세요. 가능한 한 전문 용어 대신 일상적인 표현을 사용하세요.
평이한 언어를 사용하는 것은 내용을 단순화하는 것이 아니라, 작성한 내용과 사용자가 이해하는 내용 사이의 간극을 줄이는 것입니다.
엔지니어링 팀을 위한 내부 릴리스 노트는 기술적인 내용을 담을 수 있으며, 그렇게 해야 합니다. 이 단계는 고객을 대상으로 하는 릴리스 노트에 적용됩니다.
대부분의 독자가 빠르게 훑어볼 수 있도록 명확하고 간단한 표현을 사용하세요. 소비자용 제품의 경우 문장을 짧게 하고 일상적인 어휘를 사용하는 것이 좋습니다. B2B SaaS의 경우 독자들이 다소 기술적인 용어를 용인할 수는 있겠지만, 명확성이 항상 최우선입니다.
“개선”이라는 단어를 사용할 때는 주의하세요. Teams에서는 이 단어를 모호한 포괄적 범주로 사용하는 경우가 많습니다. 대신 구체적인 표현을 통해 신뢰성을 높이세요. 예시로는 “백엔드 프로세스 개선”이 있습니다. 이 표현은 “검색 결과가 최대 40% 더 빠르게 표시됩니다”라는 표현만큼 효과적이지 않습니다.
변경된 내용을 보여주기 위해 스크린샷이나 GIF를 추가하세요
시각적인 변화는 텍스트로 설명하기 어렵습니다. 화살표나 강조 표시가 포함된 스크린샷은 대개 한 문단 분량의 설명보다 디자인 변경 사항을 더 빠르게 전달해 줍니다. 짧은 GIF는 새로운 워크플로우나 상호 작용을 설명할 때 더욱 효과적입니다. 사용자가 해당 기능이 실제로 작동하는 모습을 즉시 확인할 수 있기 때문입니다.
몇 가지 최고의 실행 방식:
- 인터페이스 업데이트 시 설명이 포함된 스크린샷을 활용하세요
- GIF는 15초 미만으로 유지하세요
- 스크린샷과 이미지에 대체 텍스트를 추가하세요
- 애니메이션이나 GIF에 캡션을 추가하세요
블렌더(Blender) 팀이 시각 자료를 활용해 제품 변경 사항을 아주 알기 쉽게 설명하는 방식이 정말 인상적입니다. 한번 살펴보세요.

이 과정에서 큰 도움이 되는 실용적인 습관이 하나 있습니다. 스프린트마다 공유 스크린샷 폴더를 관리하세요. 그렇지 않으면 릴리스 노트 작성자가 막판에 자료를 찾아 헤매게 될 것입니다.
영업 팀의 문구 없이 브랜드의 목소리에 맞춰 작성하기
릴리스 노트는 소통의 접점이지, 제품 마케팅 채널이 아닙니다. 사용자들은 개성 있는 표현은 용인하지만, 프로모션 내용은 싫어합니다.
일부 기업은 재치 있고 개성 넘치는 릴리스 노트로 유명합니다. Slack의 앱 스토어 업데이트 공지(“몇 가지 버그를 수정하고 버그들에게 엄중히 훈계했습니다”)가 통하는 이유는, 그 캐주얼한 어조가 다른 모든 곳에서 보여주는 브랜드 이미지와 잘 어울리기 때문입니다. 브랜드의 어조가 정중하고 정확하다면, 변경 내역에서 갑자기 농담을 던지지 마세요.
유용한 테스트 방법 하나: 릴리스 노트를 소리 내어 읽어보세요.
지원 엔지니어가 고객에게 자연스럽게 할 법한 말처럼 들린다면, 어조가 적절할 확률이 높습니다. 보도자료처럼 들린다면 다시 작성하세요.
사용자 피드백을 유도하고 피드백 루프를 완성하세요
각 릴리스 노트의 마지막에는 피드백을 수집할 수 있는 간단한 방법을 포함하세요. 답글 링크, 반응 옵션, “도움이 되었나요?”라는 프롬프트, 또는 피드백 게시판 링크 등이 있습니다.
릴리스 노트는 사용자가 제품 변경 사항에 적극적으로 관심을 기울이는 몇 안 되는 순간 중 하나입니다. 따라서 릴리스 노트는 사용자 심리를 파악할 수 있는 강력한 지표가 됩니다.
중요한 점은 나중에 피드백 루프를 완성하는 것입니다. 사용자가 변경 사항을 요청하고 팀이 이를 반영했다면, 향후 릴리스 노트에 그 사실을 언급하세요. “사용자 요청에 따라 반영했습니다”와 같은 간단한 문구 하나만으로도 놀라울 정도로 빠르게 신뢰를 쌓을 수 있습니다.
릴리스 노트는 어떻게 배포해야 할까요?
목표 고객층에 맞는 채널을 선택하고, 폭넓게 다루기보다는 일관성을 유지하는 데 커밋하세요.
- 앱 내 알림 또는 모달 창: 가시성이 높기 때문에 주요 릴리스에 가장 적합합니다. 알림 피로를 유발하지 않도록 적당히 사용하세요.
- 전용 변경 내역 페이지: 사용자가 언제든지 다시 확인할 수 있는 검색 가능한 아카이브를 생성합니다. 이곳은 앱의 모든 릴리스 노트를 확인할 수 있는 공식 홈 페이지입니다.
- 이메일: 업데이트 수신을 동의한 적극적인 사용자에게 효과적입니다. 이메일 내용은 간결하게 작성하고, 전체 릴리스 노트와 연결된 링크를 포함하세요.
- 앱 스토어 업데이트 설명: 모바일 앱에 필수 사항입니다. 문자 한도 제한이 있으므로, 앱 스토어 릴리스 노트에는 가장 중요한 변경 사항 두세 가지를 우선적으로 기재하세요.
- 내부 채널(Slack, Teams, ClickUp 채팅 또는 공유 문서): 지원팀, 영업 팀, 고객 서비스 팀을 대상으로 하는 내부 릴리스 노트를 위한 공간입니다. 외부 릴리스 노트가 공개되기 전에 게시하여 해당 팀들이 갑작스러운 상황에 당황하지 않도록 하세요.
- 소셜 미디어나 블로그: 선택 사항이며, 주로 대규모 출시나 대중의 관심을 끌 만한 기능이 있을 때 활용하는 것이 좋습니다.
대상 고객층에 맞는 채널 두세 곳을 선택하고, 해당 채널에 꾸준히 콘텐츠를 게시하세요. 품질이 들쑥날쑥한 상태로 모든 채널에 콘텐츠를 퍼뜨리는 것보다, 두세 개의 채널을 제대로 운영하는 편이 훨씬 낫습니다.
예를 들어, ClickUp에서는 ClickUp Docs에 분기별로 정리된 공개 변경 내역을 매주 업데이트하여 게시합니다. 이후 이 업데이트 내용은 이메일, 앱 내 알림, 소셜 미디어, 블로그 게시물, 그리고 주요 출시 시에는 YouTube 비디오를 통해 배포됩니다. 변경 내역은 유일한 신뢰할 수 있는 정보원이며, 그 외의 모든 채널은 이를 보완하는 역할을 합니다.
비하인드 스토리: ClickUp에서 릴리스 노트를 관리하는 방법
저희 제품 팀은 매주 업데이트를 출시합니다. 이러한 업데이트는 수백만 명의 사용자에게 명확하고, 시의적절하며, 쉽게 찾을 수 있는 방식으로 전달되어야 합니다. ClickUp을 벗어나지 않고 이를 어떻게 해내는지 소개해 드리겠습니다.
모든 것은 작업에서 시작됩니다. 기능이나 수정 사항이 출시 준비가 되면, 엔지니어링 팀은 ClickUp 작업에서 해당 작업을 ‘완료’ 상태로 변경합니다. 이 한 번의 작업으로 릴리스 노트 워크플로우가 시작됩니다. 이제 더 이상 개발자의 어깨를 톡톡 두드리며 “이건 무슨 기능이에요?”라고 물어볼 필요가 없습니다.
AI 슈퍼 에이전트가 초안을 작성합니다. 작업이 완료되면, 해당 작업을 모니터링하던 ClickUp 슈퍼 에이전트가 자동으로 릴리스 노트 초안을 생성합니다. 이 초안은 작업 설명, 상위 에픽, 연결된 항목에서 관련 정보를 추출합니다. 초안은 작업에 댓글로 게시되므로 팀 전체가 가시성을 가질 수 있습니다. 팀원들은 여전히 결과물을 검토하고 편집하지만, 이를 통해 주간 릴리스 시 초안 작성 시간을 대폭 단축할 수 있습니다.
최종 버전은 ClickUp Docs에 저장되어 있습니다. 저희 릴리스 노트는 ClickUp Docs에 분기별로 정리되어 있습니다. 각 문서 페이지는 한 주간의 릴리스를 다루며, 명확한 제목, 간결한 설명, GIF 또는 스크린샷, 도움말 문서 링크로 구성되어 있습니다. 책임 소재를 명확히 하기 위해 문서 상단에는 문서 소유자와 기여자가 목록으로 표시되어 있습니다.
ClickUp Docs는 실시간 협업을 지원하기 때문에, 엔지니어링 팀과 제품 마케팅 팀이 Google Doc 링크를 주고받지 않고도 같은 공간에서 내용을 검토하고 의견을 남길 수 있습니다.
팀원들에게 자동으로 알림이 전송됩니다. ClickUp Docs에서 릴리스 노트의 상태가 “게시됨”으로 변경되면 ClickUp 자동화 기능 (또는 전담 슈퍼 에이전트) 이 작동합니다. 변경 내역 알림이 지원 및 고객 서비스 채널로 전송됩니다. 고객이 업데이트를 확인하기 전에 내부 팀원들에게 먼저 알림이 전달됩니다.
배포는 여러 채널을 통해 이루어집니다. 릴리스 노트가 승인되면 다음 경로를 통해 배포됩니다:
- 공개 변경 내역 (유일한 신뢰할 수 있는 정보원)
- 활성 사용자를 위한 앱 내 알림
- 사용자층에 이메일 업데이트를 보내기
- 주요 기능 출시를 위한 블로그 게시물
- 대규모 업데이트를 위한 소셜 미디어 및 YouTube 비디오

이것이 팀에 중요한 이유. 팀원들에게 최신 정보를 전달하기 위해 별도의 wiki, Notion 페이지, Confluence 스페이스, Slack 채널이 필요하지 않습니다. 하나의 작업 공간에서 계획, 작성, 검토, 게시까지 모두 처리할 수 있습니다. 개발자는 코딩에 집중할 수 있고, PM은 출시된 내용을 즉시 파악할 수 있으며, 사용자는 언제든지 정보를 확인할 수 있는 곳을 알 수 있습니다.
한 가지 솔직한 주의사항: 이 워크플로우는 이미 ClickUp을 사용하고 있는 팀을 위해 마련된 것입니다. 팀에서 다른 프로젝트 관리 도구와 별도의 wiki를 사용하고 있다면, 릴리스 노트 작성만을 위해 시스템을 이전하는 데 드는 수고가 그만한 가치가 없을 수도 있습니다. 하지만 이미 스프린트와 문서를 한 곳에서 관리하고 있다면, 릴리스 노트 작성 프로세스는 자연스럽게 통합될 수 있습니다.
참고할 만한 릴리스 노트 예시 5가지
저희 회사의 릴리스 노트 외에도, 참고할 만한 릴리스 노트 예시 5가지를 소개합니다.
Slack: 명확성을 해치지 않으면서 개성을 살리는 방법

릴리스 노트 예시를 살펴보면, Slack의 업데이트 공지는 캐주얼하고 재치 있는 어조로 유명합니다.
하지만 유머가 유용한 정보를 대체할 수는 없습니다. 릴리스 노트에는 여전히 무엇이 변경되었는지, 무엇이 수정되었는지, 그리고 사용자가 앞으로 무엇을 기대할 수 있는지에 대한 설명이 담겨 있습니다.
핵심 요점: 균형입니다. 구조가 체계적이고 한눈에 파악하기 쉬울 때 개성 있는 표현이 가장 효과적입니다.
다음과 같은 경우 참고하세요: 마케팅 사이트, 고객 지원 답변, 소셜 미디어 등 다른 모든 채널에서 이미 캐주얼하고 재치 있는 브랜드 목소리를 유지하고 계신다면, 일관성을 유지하는 것이 성공의 열쇠입니다.
장단점: 유머는 시간이 지나면 색이 바래고, 번역하면 더 나빠집니다. 영어로는 통했던 농담도 현지화된 릴리스 노트에서는 통하지 않을 수 있으며, 2019년에 재치 있게 들렸던 문장도 2026년이 되면 어색하게 느껴질 수 있습니다. 편집 비용을 따로 책정하거나, 유머를 최소한으로 줄이세요.
선형적: 간결하고, 개발자 중심이며, 한눈에 파악하기 쉬운

Linear는 릴리스 노트를 매우 간결하게 작성합니다. 대부분의 업데이트는 한 문장으로 요약되며, ‘기능’, ‘개선 사항’, ‘오류 수정’과 같은 카테고리별로 분류됩니다.
그 결과, 긴 설명을 원치 않는 기술 사용자들이 한눈에 파악하기 쉬운 업데이트 정보를 얻을 수 있습니다.
핵심 요점: 대상 독자가 이미 제품에 대해 깊이 이해하고 있다면, 릴리스 노트는 짧을수록 좋은 경우가 많습니다.
다음과 같은 경우 참고하세요: 매주 변경 내역을 확인하며 새로운 기능이 무엇인지 간단히 파악하고자 하는 개발자나 파워 사용자들을 대상으로 서비스를 제공하는 경우. 한 줄 요약은 그들의 시간을 존중합니다.
단점: 한 줄짜리 노트는 독자가 알지 못할 수도 있는 맥락을 전제로 합니다. 신규 사용자, 기술에 익숙하지 않은 구매자, 그리고 가끔 사용하는 사용자들은 이탈할 것입니다. 여러분이 최적화해야 할 대상은 이미 제품을 사용하고 있는 사람들이지, 새로 유치하려는 사람들이 아닙니다.
Notion: GIF 삽입을 통한 시각 중심 접근

Notion은 ‘새로운 기능’ 업데이트에서 GIF와 스크린샷을 적극적으로 활용합니다.
워크플로우를 상세히 설명하는 대신, 상호작용을 직접 보여줍니다. 텍스트는 주된 설명이 아닌 보조적인 맥락으로 활용됩니다.
대부분의 변경 사항이 시각적인(새로운 블록, 업데이트된 메뉴, 드래그 앤 드롭 동작 등) 제품의 경우, 이 형식은 어떤 문단보다 더 빠르게 정보를 전달합니다.
핵심 요점: 변경 사항이 시각적인 것이라면, 설명하기보다는 직접 보여주세요.
다음과 같은 경우 이 방법을 활용해 보세요: 제품이 인터페이스 위주이고, 대부분의 업데이트가 사용자가 보거나 클릭하는 내용을 변경하는 경우. GIF를 사용하면 한 단락 분량의 설명을 3초 만에 전달할 수 있습니다.
단점: GIF는 제작 비용이 많이 들고 로딩 속도가 느리며, API 업데이트, 청구 로직, 백엔드 성능 개선과 같은 비시각적 변경 사항에는 적합하지 않습니다. 이 형식에 지나치게 의존하면 릴리스 노트가 디자인 프로젝트로 변질될 수 있습니다.
GitHub: 확장성을 고려한 구조

GitHub은 매달 수백 건의 업데이트를 배포합니다. GitHub의 릴리스 노트는 제품 영역별로 분류하고, 날짜 표시와 확장 가능한 세부 정보를 포함함으로써 관리하기 쉬운 형태를 유지하고 있습니다.
사용자는 방대한 변경 내역을 일일이 샅샅이 뒤지는 대신, ‘작업’, ‘보안’ 또는 ‘코파일럿’과 같은 항목별로 필터링할 수 있습니다.
핵심 요점: 릴리스 속도가 빨라지면, 글의 품질만큼이나 내비게이션도 중요해집니다.
다음과 같은 경우 참고하세요: 여러 제품 영역에 걸쳐 매달 수십 건의 업데이트를 배포하지만, 사용자들은 그중 일부 기능에만 관심을 갖는 경우. 핵심은 ‘필터링’ 기능입니다.
장단점: 구조 위주의 변경 내역은 비인격적으로 느껴지고 서사적 흐름이 끊깁니다. 제품 분야별로 훑어보는 사용자는 제품이 어떤 방향으로 나아가고 있는지에 대한 큰 그림을 결코 파악할 수 없습니다. 분기별 ‘출시 내역’ 요약과 함께 제공하여 일관된 흐름을 유지하세요.
Superhuman: 사용자에게 미치는 영향을 강조하는 헤드라인

Superhuman은 기술적 설명 대신 사용자 성과 중심으로 릴리스 노트를 작성합니다.
“새로운 키보드 바로 가기 지원이 추가되었습니다”라고 말하는 대신, “새로운 연기 바로 가기로 더 빨리 ‘받은 편지함 제로’를 달성하세요”라고 작성합니다.
대부분의 독자에게는 제목 자체가 릴리스 노트나 다름없습니다. 자세한 내용을 알고 싶은 사람만이 링크를 클릭해 들어옵니다.
핵심 요점: 제목을 효과적으로 활용하세요.
다음과 같은 경우 참고하세요: 제품에 명확하고 측정 가능한 사용자 성과(X가 더 빨라짐, Y가 줄어듦, Z에 도달)가 있으며, 사용자가 링크를 클릭하지 않아도 그 가치를 체감할 수 있도록 하고 싶을 때.
장단점: 결과 중심의 제목은 실질적인 결과가 뒷받침되어야 합니다. 변경 사항이 점진적이거나 기술적인 경우, 과장된 표현을 쓰고 싶은 유혹에 빠지기 쉬우며, 사용자들은 이를 눈치챌 것입니다. “받은 편지함을 더 빨리 비우세요”라는 문구가 효과적인 이유는 해당 기능이 실제로 그 효과를 발휘하기 때문이지만, “새로운 색상 선택기로 워크플로우를 간소화하세요”라는 문구는 그렇지 않습니다.
잘 작성된 릴리스 노트로 도입률을 높이세요
릴리스 노트는 문서 형태로 위장된 사용자 유지 전략입니다. 우선순위 분류(공지, 포함, 생략)를 올바르게 하고, 사용자에게 미치는 영향을 가장 먼저 강조하며, 지속적으로 관리할 수 있는 채널을 선택하세요. 나머지는 편집 작업입니다.
또한 작업, 문서, 피드백, AI 초안 작성 도구가 모두 하나의 작업 공간에 통합되면 전체 프로세스를 훨씬 더 쉽게 관리할 수 있습니다. 팀이 릴리스 노트를 배포하기 위해 티켓, 문서, Slack 스레드를 오가며 번거로움을 겪고 있다면, ClickUp을 무료로 시작해 전체 워크플로우를 하나의 작업 공간에서 관리해 보세요.
릴리스 노트 작성에 관한 자주 묻는 질문
릴리스 노트는 어느 정도 길이가 적당할까요?
개별 릴리스 노트는 50~300단어 이내로 작성하세요. 사소한 수정 사항이라면 한 문장으로 충분하지만, 복잡한 변경 사항의 경우 2~3문장에 스크린샷이나 링크를 추가하는 것이 좋습니다. Linear는 사용자가 기술에 익숙하고 제품이 명확한 방향성을 가지고 있기 때문에 대부분의 업데이트를 한 줄로 요약합니다. 반면 Notion은 변경 사항이 시각적이며 GIF가 필요하기 때문에 릴리스 노트가 더 길게 작성됩니다. 길이는 템플릿의 기본값이 아니라 변경 사항의 복잡도에 맞춰야 합니다.
릴리스 노트는 얼마나 자주 게시해야 할까요?
마케팅 달력이 아닌, 릴리스 주기에 맞춰 진행하세요. 매일 업데이트를 배포하는 팀(GitHub, Linear)은 사용자가 부담스럽지 않도록 업데이트를 묶어 주간 요약 형태로 제공합니다. 매월 업데이트를 배포하는 팀은 릴리스별로 공개합니다. 사소한 업데이트는 수정 사항마다 알림을 보내는 대신, 한 번에 모아 요약 형태로 제공할 수 있습니다. 제품이 개선되고 있음을 알릴 수 있을 만큼의 빈도를 유지하되, 사용자가 지루해할 정도로 너무 잦지는 않게 하세요.
릴리스할 때마다 릴리스 노트를 작성해야 할까요?
아닙니다. 먼저 각 변경 사항을 선별하세요. 변경 사항이 사용자 행동이나 인터페이스에 영향을 주지 않는다면 생략하세요. 백엔드 리팩토링이나 내부 최적화는 엔지니어링 로그에 기록해야 합니다. 측정 가능한 영향이 없는 “성능 개선”에 대한 노트는 사용자가 향후 공지 사항을 무시하도록 만들 수 있습니다. 고객이 직접 보고, 느끼거나, 이에 따라 행동하게 될 변경 사항에 대해서만 고객 대상 노트에 포함시키세요. 나머지는 내부 문서로 기록하세요.
릴리스 노트가 SEO와 제품 노출도에 영향을 미칠까요?
네, 인덱스된 페이지에 게시될 경우 그렇습니다. 공개된 /changelog 또는 /whats-new 페이지는 기능 이름, 연동 기능, 비교 검색에 대한 롱테일 노출을 확보해 줍니다. GitHub, Linear, Notion은 모두 변경 내역을 인덱스하며, 기능 이름 쿼리 시 마케팅 문구보다 해당 페이지들이 더 상위에 노출되는 경우가 많습니다. 검색 최적화를 지나치게 하지는 마세요. 하지만 로그인 장벽 뒤나 자바스크립트 전용 위젯 뒤에 숨겨두지도 마세요.
좋은 릴리스 노트는 어떻게 작성할까요?
좋은 릴리스 노트는 사용자에게 미치는 영향을 한 줄로 요약한 헤드라인(“검색 결과 로딩 속도가 3배 빨라졌습니다”)으로 시작하며, 변경 사항을 3~5개의 고정된 카테고리(신규 기능, 개선 사항, 수정 사항, 알려진 문제, 호환성 변경 사항)로 분류하고, 모든 내용을 본문에 직접 설명하기보다는 관련 문서로 연결된 링크를 제공합니다. 각 줄은 변경된 코드 내용이 아닌, 사용자가 얻게 되는 결과 중심으로 작성하세요. 작업이 진행되는 동안 티켓 내에 릴리스 노트를 작성하고, 게시하기 전에 크로스-기능 검토를 진행하세요.