릴리스 날짜가 가까워지고 빌드가 성공했고 QA 팀이 승인했지만 alguien이 팀이 늦게 들은 질문을 물어보는 경우가 있습니다: "릴리스 노트를 작성하는 사람 누구인가?"
그때부터 혼란이 시작됩니다. 개발자들은 커밋을 빠르게 훑어보고 제품 팀은 Jira를 확인하고 지원 팀은 고객에게 공개된 3개의 수정 사항을 기억합니다. 마케팅 팀은 더 간결한 요약을 원합니다. 릴리스 노트가 공개되기까지, 노트는 사용자에게 도움이 되지 않거나 너무 추상적이어서 변경 사항이 무엇인지 설명하지 못합니다.
좋은 애플리케이션 릴리스 노트는 릴리스 프로세스의 마지막 단계에서 발생하지 않습니다. 노트는 변경 사항이 아직 빌드, 검토, 배포 중인 시점에 workflow가 시작됩니다. 릴리스 노트를 배달 과정의 일부로 다루면 팀은 더 빠르게 릴리스 노트를 공개하고 중요한 세부 사항을 놓치지 않고 사용자에게 더 rõ ràng한 릴리스 정보를 제공할 수 있습니다.
목차
- 강력한 릴리스 노트의 비밀 무기
- 릴리스 정보를 체계적으로 얻는 방법
- 개발 및 포맷 노트를 읽을 사람들을 위해 쓰기
- 다양한 채널과 청중을 위한 릴리스 노트 출판 전략
- CI/CD 및 현대적인 도구를 사용한 릴리스 노트 자동화
- 롤백 및 규정 준수에 대한 기업급 노트
강력한 릴리스 노트는 비밀 무기입니다
많은 사람들이 애플리케이션 릴리스 노트를 패키징 물질로만 생각합니다. 필요하지만 중요하지 않습니다. 이러한 마음가짐은 의미 있는 결정이 이미 이루어진 후에 작성하기 때문에 약한 노트를 만듭니다.
보다 나은 관점은 단순합니다. 릴리스 노트는 제품 커뮤니케이션의 일부입니다. 사용자에게 변경된 내용, 중요성, 다음 단계를 알려줍니다. 릴리스 노트 구조에 대한 지침은 이제 엔지니어링 로그에서 벗어나 사용자에게 보이는 형식으로 이동했습니다. 헤더, 개요, 이슈 요약, 해결, 영향 섹션과 주요 릴리스에 대한 더 자세한 설명, 미니 릴리스에 대한 짧은 요약이 포함된 구조로, 이에 대한 설명이 있습니다. 이 가이드를 참조하세요.
릴리스 노트 구조에 대한 지침이 이동한 이유는 중요합니다. 사용자는 제품을 스프린트 보드처럼 경험하지 않습니다. 사용자는 제품에 대한 신뢰를 경험합니다. 애플리케이션이 변경되었을 때 사용자가 왜 변경되었는지 이해하지 못하면 신뢰가 떨어집니다. 새로운 기능이 출시되었을 때 nobody가 이를 알지 못하면 릴리스는 여전히 발생하지만 가치가 착지하지 않습니다.
강력한 릴리스 노트가 실제로 무엇을 하는지
강력한 릴리스 노트는 세 가지 방식으로 도움이 됩니다:
- 사용자에게 기대치를 설정합니다: 사용자는 변경이 화려한 것인지, 기능적인 것인지, 사용자가 행동을 취해야 하는 것인지 알 수 있습니다.
- 그것의 표면 가치: 기능 발표는 매장 설명 또는 지원 문서에 묻혀서, timely 릴리스 노트와 같은 주목을 받지 못합니다.
- 그것은 혼란을 줄입니다: 지원 팀은 문제가 해결, 변경, 또는 여전히 출시 중인지 설명하는 데 시간을 덜 소비합니다.
실용적인 규칙: 사용자가 몇 초 안에 릴리스가 자신에게 영향을 미치는지 알 수 없다면, 노트는 고객에게 쓰여지지 않은 것입니다.
이것은 특히 제품에 반복적인 업데이트가 있는 경우尤其 중요합니다. 명확한 커뮤니케이션 없이 빈번한 변경은 불안정하게 느껴지지만, 명확한 커뮤니케이션과 빈번한 변경은 활발하고 반응적인 것으로 느껴집니다. 이러한 차이는 시간이 지나면서 수용, 고객 신뢰 및 유지율에 영향을 미칩니다. 사용자 참여에 대한 고려를 하는 팀은 릴리스 커뮤니케이션을 온보딩 및 습관 형성을 위한 시스템과 동일하게 다루어야 합니다. 릴리스 메시징은 더 광범위한 대화에 속하는 것이기도 합니다. 앱 사용자 유지율을 개선하는 것.
Weak 노트의 예
Weak 노트는 일반적으로 세 가지 방법 중 하나로 실패합니다.
| 문제 | 사용자가 보는 것 | 무엇이 발생하는지 |
|---|---|---|
| 너무 기술적 | 내부 용어, 티켓 ID, 구현 세부 사항 | 사용자는 업데이트를 무시합니다 |
| 너무 추상적 | 버그 수정 및 개선 | 사용자는 업데이트를 이해하지 못합니다 |
| 업데이트가 늦습니다 | 릴리스 노트가 출시 후에 게시됩니다 | 사용자는 혼란을 연결하지만, 안내를 연결하지 않습니다 |
잘 제작된 릴리스 노트는 주된 업무가 아닙니다. 릴리스 노트는 제품의 몇 가지 항목 중 하나로, 배포와 이해 사이에 직접 위치합니다. 그 이유로, 그들은 비밀 무기입니다. 팀은 그들을 충분히 투자하지 않습니다. 따라서, 규율된 팀은 단순히 더 명확하게 되기만 하면, 빠르게 선제적으로 나타납니다.
릴리스 정보를 체계적으로 제공하는 방법
일반적인 릴리스 노트는 일반적인 수집으로 시작합니다. 만약 입력이 GitHub, Jira, Slack, QA 쓰레드, 그리고 지원 티켓에 흩어져 있다면, 작성 프로세스는 추측에 의존하게 됩니다.
강력한 워크플로우는 개발, 버전 관리, 그리고 프로젝트 관리 시스템에서 변경 사항을 pull하는 것으로 시작합니다. 그 다음으로 사용자 영향에 따라 정렬하여 중요한 항목이 먼저 나타나고, 변경 사항이 명확하게 표시되도록 합니다. 이 릴리스 노트 워크플로우 템플릿은 monday.com에서 추천하는 구조입니다. 이 릴리스 노트 워크플로우 템플릿은 monday.com에서 추천하는 구조입니다.이 릴리스 노트 워크플로우 템플릿은 monday.com에서 추천하는 구조입니다.
이 릴리스 노트 워크플로우 템플릿은 monday.com에서 추천하는 구조입니다.
릴리스 인풋 PIPELINE을 하나로 만들세요.
실용적인 pipeline은 일반적으로 다음과 같이 pull합니다:
-
실용적인 PIPELINE은 일반적으로 다음과 같은 항목에서 추출합니다. Commit history는 code의 실제 기록입니다. 팀이 Conventional Commits를 사용한다면 추출이 더 쉬워집니다.
feat,fix,refactor, andbreaking버전 관리 CI/CD 자동화와 Conventional Commits. -
프로젝트 관리 Jira, Linear, Asana, ClickUp 등은 Git이 부족한 평문 설명을 포함합니다. 티켓에는 수락 기준, 레이블, 우선순위, 고객 요청과 관련된 정보가 포함되어 있습니다. 이러한 컨텍스트는 변경이 릴리스 노트에 포함되어야 하는지 결정하는 데 도움이 됩니다.
-
지원 및 성공 입력 지원 팀은 사용자가 불편을 겪는 버그를 알고 있습니다. 고객 성공 팀은 특정 기능을 요청한 계정에 대해 알고 있습니다. 이러한 채널을 무시하면 노트는 백엔드 작업에 중점을 두고 고객이 관심을 가질 수 있는 내용을 과소평가할 것입니다.
-
QA 및 릴리스 관리 QA 팀은 릴리스에 포함된 변경 사항을 확인할 수 있습니다. 이는 명백한 것처럼 보이지만, 팀은 계획된 변경 사항 대신 실제로 배포된 변경 사항에 대해 작성하는 경우가 많습니다.
릴리스 자료를 수집하는 것은 모든 변경 사항을 찾는 것이 아니라 사용자가 알 수 있는 변경 사항, 운영자에게 알려야 하는 변경 사항, 개발자가 나중에 필요로 할 변경 사항을 식별하는 것입니다.
변경 사항을 순위 매기기
릴리스 자료가 준비되면, 변경 사항을 영향 등급으로 분류합니다. 평평한 백로그 덤프에서 작성하기 시작하지 마십시오.
다음은 간단한 분류 모델입니다:
- Tier A: 새로운 기능, 주요 UX 변경, 기능 중단, 가격 또는 액세스 변경, 보안 관련 수정
- 등급 B: 기존 워크플로우에 의미 있는 개선, 사용자가 느낄 수 있는 신뢰성修정, 중요한 관리자 변경
- 등급 C: 소수점 고정, 시각적 마무리, 낮은 가시성 유지 작업
이 등급은 두 가지 일반적인 문제를 해결합니다. 첫째, 높은 영향 항목이 작은 고정의 쌓인 쌓아 올려지지 않도록합니다. 둘째, 검토자가 위험이 가장 높은 곳에 집중할 수 있으므로 승인 과정이 더 쉬워집니다.
릴리즈 노트의 참조 소스 만들기
_draft_ 자체가 참조 소스가 아닙니다. 쓰기 시작하기 전에 구조화된 릴리즈 레코드를 사용하세요.
다음 필드를 포함하세요:
- 버전 또는 빌드 식별자
- 릴리즈 날짜
- 변경 소유자
- 사용자 대면 요약
- 대상
- 위험도
- 필요한 작업
- 롤백 고려사항
- 링크: 티켓, PR, 문서
해당 레코드는 notion, airtable, 구글 시트, 마크다운 파일, 또는 릴리즈 데이터베이스에 저장할 수 있습니다. 도구의 중요성은 일관성보다 더 중요합니다. 중요한 것은 모든 배포된 항목이 한 곳을 통과하고 alguien이 글을 쓰기 전에 prose를 작성하는 것입니다.
팀이 이것을 잘 수행하면 글쓰기는 편집이 됩니다. 팀이 이것을 생략하면 글쓰기는 고고학이 됩니다.
사용자가 읽을 수 있는 글쓰기 및 형식 지침
애플리케이션 릴리스 노트가 실패하는 이유는 대부분 내부 작업의 형태를 보존하기 때문입니다. 사용자는 컨트롤러가 리팩토링되었거나 마이그레이션 스크립트가 정리되었는지 관심이 없습니다. 사용자는 로그인에 더 신뢰할 수 있게 작동하거나 리포트를 더 쉽게 내보낼 수 있게 하거나 불편한 버그가 사라진 것을 중요하게 생각합니다.
업데이트 가이드라인은 노트를 카테고리별로 나누는 것을 권장합니다. 새로운, 개선, and 수정, and it specifically points out that quantified outcomes such as “search results now load 40% 빠르게” are easier to read than implementation details, as shown in these Appcues에서 제공하는 .
사용자가 스캔하고 읽는 순서로 진행되도록 구조를 구성하세요.
That advice works because most users scan first and read second. A clear format reduces friction.
구성 요소
| 내용 | 제목 |
|---|---|
| Header | 제품 이름, 릴리스 번호, 날짜 |
| 개요 | 릴리스 노트 |
| 새로운 | 새로운 기능 또는 사용 가능한 워크플로우 |
| 개선된 | 기존 기능이 더 잘 작동하는 기능 |
| 수정된 | 버그 수정 또는 문제 해결 |
| 필요한 조치 | 사용자 또는 관리자가 해야 할 일 |
| 기술 참고서 | 개발자, 관리자, 또는 지원자용 참고 사항 |

포맷은 단어보다도 중요합니다. 짧은 섹션, 가시적인 레이블, 날짜가 있는 항목은 릴리스 히스토리를 빠르게 훑어보는 것을 쉽게 만듭니다. 릴리스 노트가 여러 릴리스를跨하는 경우 사용자에게 검색 가능한 아카이브를 제공하는 것이 좋습니다. 사용자에게 긴 블로그 피드에서 스크롤하도록 강요하지 마십시오.
기술 작업을 사용자 가치로 번역하십시오
번역하는 데 필요한 핵심 기술은 번역입니다. 구현에서 언어를 변경하여 영향력을 전달하는 데 있어 엔지니어링의 진실을 유지해야 합니다.
다음 예시를 참조하십시오:
Before
검색 인덱스 PIPELINE을 재구성하고 동기식 쿼리 핸들러를 최적화했습니다.
다음
개선
검색 결과가 로드됩니다. 40% 빠르게 대형 데이터 세트를 필터링할 때 기다리는 시간이 줄어듭니다.
두 번째 버전은 사용자에게 변경된 내용, 영향을 받는 곳, 그리고 그들이 관심을 가질 이유를 알려줍니다. 기술적인 작업을 숨기지 않습니다. 그들을 해석합니다.
다른 예시:
- Weak: 토큰 리프레시 에지 케이스와 관련된 문제를 수정했습니다.
- Better: Fixed 강력한 변경 사항은 일반적으로 한 문장에 세 가지 일을 합니다:
visible change
- 영향을 받는 워크플로우를 명시합니다.
- 사용자에게 미치는 영향을 설명합니다.
- Fixed issue with token refresh edge case
실용적인 템플릿
품질을 유지하기 위해 반복적인 문구가 필요합니다.
이 패턴을 사용하세요:
- 사용자에게 보이는 결과를 먼저 설명하세요.
- 필요한 만큼의 맥락을 추가하세요.
- 영향이나 행동을 강조하세요.
예시:
- 새 컨텍스트: Live updates product page. 역할: Short UI label or navigation item. 메시지 키 `live_update_lts_electron_new` (Live Update Lts Electron New).
- Improved 개선됨
- Fixed 이미지 첨부물이 댓글 쓰레드에 나타나지 않는 문제가 발생했습니다.
모바일 또는 하이브리드 앱을 관리하는 경우, 릴리즈 노트와 변경 로그에 대한 하나의 스타일 가이드를 유지하는 것이 도움이 됩니다. 릴리즈 노트와 변경 로그에 대한 하나의 스타일 가이드를 유지하는 것이 도움이 됩니다. 앱 스토어, 인앱 공지, 내부 문서에서 일관된 목소리를 유지할 수 있습니다. 유용한 운영 참조는 이 가이드입니다. Capacitor 릴리즈 노트 관리 가이드.
기본적인 본문에서 implementation 세부 사항을 제외합니다. 설정, 마이그레이션, 호환성 변경이 있는 경우에만 본문에 포함합니다. 대부분의 사용자는 아키텍처에 관심이 없습니다. 그들은 결과에 관심이 있습니다.
마지막 규칙입니다. ‘버그 수정 및 개선’이 단독으로 나타나지 않도록 하십시오. 이 문구는 사용자에게 배포한 내용이 무엇인지 알려주지만, 그 내용이 중요하다는 것을 알려주지 않습니다. 만약 수정이 중요하다면, 명확하게 이름을 지어주십시오.
다양한 채널과 대상자에 대한 릴리즈 노트 배포 전략
같은 릴리즈 노트가 모든 채널에서 동일하게 보이지 않도록 하십시오. 내부 개발자, 사용자, 지원 담당자, 베타 테스터는 동일한 세부 정보를 필요로 하지 않습니다. 모든 채널에 동일한 노트를 푸시하면, 각 대상자는 올바른 정보 수준을 얻지 못합니다.
다중 대상자 제품의 경우,-layered 형식이 실용적인 패턴입니다. 짧은 평문 요약부터 시작하여 사용자에게 친화적인 세부 정보를 추가한 다음 implementation 노트, API 또는 마이그레이션 지침, 문제 해결에 대한 기술적 부록을 추가할 수 있습니다. 이 접근 방식은 이 서비스 노우의 릴리즈 노트 최적화 방법에 대한 토론에서 설명되어 있습니다..
하나의 릴리즈, 여러 독자
이러한 대상자가 실제로 어떻게 다르다는 것을 보여드리겠습니다.
| 대상자 | 사용자에게 필요한 것 | 피해야 할 것 |
|---|---|---|
| 최종 사용자 | rõ한 이점, 눈에 띄는 변경 사항, 작업 항목 | 티켓 ID, 구현 세부 사항 |
| 기술 전문가 | 버전 정보, 마이그레이션, API 노트, 알려진 문제 | 마케팅 용어로 특정 사항을 숨기는 것 |
| 내부 팀 | 지원 지침, 배포 타이밍, 심각도 | 공개된 단순화로 운영 위험을 숨기는 것 |
| 베타 테스터 | 이 코호트에서 무엇이 바뀌었는지, 어떤 피드백이 필요합니까? | 전사 차이로그 노이즈 |
layered note는 한 번에 작성하고 여러 번에 게시할 수 있습니다. 요약은 앱 내 카드 또는 푸시 메시지로, 중간层는 공공 차이로그 엔트리로, 부록은 문서, GitHub 릴리스 또는 내부 위키로 이동할 수 있습니다.
어떤 채널이 어떤 일에 적합합니까?
어떤 채널은 속도가 더 빠르지만, 다른 채널은 세부 사항이 더 중요합니다.
- 앱 내 알림: 사용자가 변화에 직면할 때 순간적인 요약과 관련된 짧은 알림이 적합합니다.
- 차이로그 페이지 또는 블로그 게시물: 지속적인 역사, 검색, 및 링크에 더 적합합니다.
- 이메일 요약: 관리자, 챔피언, 및 고객 중 일일 로그인하지 않는 사람들에게 유용합니다.
- 내부 채팅 또는 위키: 개발자 문서 또는 __CAPGO_KEEP_0__ 릴리스:
- 개발자 문서 또는 GitHub 릴리스: API의 올바른 위치는 SDK 또는 마이그레이션 상세 정보입니다.
팀이 여러 시스템에서 문서 및 릴리스 자산을 관리하는 경우, draft에서 public 상태로 이동하는 항목을 표준화하는 것이 도움이 됩니다. broader 워크플로우에 대한 실용적인 참고 자료는 MeshBase의 콘텐츠 발행을 위한 지침입니다.
콘텐츠 발행을 위한 지침 릴리스 노트가 문서, 업데이트, 지식베이스 콘텐츠와 함께 존재할 때 특히 유용합니다.사용자가 앱을 열 때는 안심하고 관련성 있는 정보를 원합니다. 개발자가 릴리스 기록을 읽을 때는 정확성을 원합니다. 지원 담당자는 두 가지 모두를 원합니다.
릴리스 노트 프로그램이 가장 효과적인 것은 배포를 디자인하는 것, 복사-붙여넣기 대신입니다. 동일한 릴리스. 다른 패키징.
CI/CD 및 현대적인 도구를 사용한 릴리스 노트 자동화
CI/CD와 최신 도구를 이용한 릴리스 노트 자동화
자동화는 반복적인 부분을 해결하지만 판단을 대체하지는 않습니다.
릴리스 노트를 자동화하는 방법

어떤 것을 자동화하고 어떤 것을 인간이 유지해야 하는가
최고의 분리는 간단합니다.
자동화:
- 변경 추출 커밋, 병합된 풀 요청, 레이블 및 연결된 이슈에서
- draft assembly 릴리스 노트 템플릿에
- 버전 및 날짜 삽입
- 게시를 위한 단계 릴리스 노트 페이지, GitHub 릴리스 또는 CMS로
- 通知 승인 후 내부 팀에 알림
인간 검토를 유지하기 위해:
- 우선 순위 및 순서
- 사용자에게 보이는 문구
- Sensitive한 변경 사항
- 롤백 언어나 깨지는 변경 사항
- 성능, 호환성, 또는 필요한 동작에 대한 모든 주장
게시하지 않고 자동화된 노트를 만들지 않도록 시간을 절약하는 분할이 있습니다. pipeline은 사실을 수집합니다. 리뷰어는 그 사실을 유용하게 만듭니다.
작동 가능한 pipeline
GitHub Actions, GitLab CI, 또는 다른 CI/CD 시스템에서 일반적으로 다음과 같은 실용적인 자동화 흐름이 있습니다:
- 릴리즈 태그 또는 릴리즈 branch로 머지하는 것이 작업을 트리거합니다.
- 스크립트는 병합된 PR 제목, 커밋 메시지, 및 연결된 이슈 메타데이터를 pulls합니다.
- 기능, 수정, 주요 변경 사항 등 라벨로 분류하는 pipe라인이 있습니다.
- 애플리케이션 릴리스 노트를 생성하여 마크다운 드래프트를 생성합니다.
- 애플리케이션 릴리스 노트의 리뷰어는 요약과 위험한 항목들을 편집합니다.
- 승인자는 노트를 게시하고 릴리스 아티팩트에 첨부합니다.
이 앱을 커스텀 스크립트, 플랫폼 내의 릴리즈 툴링, 또는 전용 헬퍼를 사용하여 빌드할 수 있습니다. 릴리즈 툴링 레이어에 대한 아이디어를 찾고 싶다면 커뮤니티를 살펴보는 것이 가치가 있습니다. 새로운 도구들을 탐험하세요.draft 생성 후 수동 정리 작업을 최소화하는 팀에게 특히 유용합니다.
Capacitor 앱을 운영하는 팀은 배포 PIPELINE 및 승인 흐름에 노트 생성을 통합할 수 있습니다. 이 GitHub 액션 통합 가이드는 Capgo live update 배포와 빌드 자동화 연결 방법을 보여줍니다.
자동화 흐름의 동영상 walkthrough입니다.
실시간 업데이트 시각 변경
Live update 환경은 새로운 문제를 야기합니다. 전통적인 스토어 기반 릴리스에서, 릴리스 노트는 일반적으로 앱 리뷰를 통해 푸시된 버전과 일치합니다. live update 워크플로에서는 사용자는 스토어 릴리스 주기 외에 자바스크립트, CSS, 복사본, 구성, 또는 자산 변경을 받을 수 있습니다.
릴리스 노트 프로세스가 두 가지 별개의 질문을 해결해야 합니다:
- 바이너리 릴리스에서 배포된 내용은 무엇인가요?
- 라이브 번들에서 변경된 내용은 무엇인가요?
오버 더 에어(Deliver Over The Air, ODTA) 지원을 하는 경우, 바이너리 노트와 후속 릴리스 업데이트 노트 간에 명확한 구분을 유지해야 합니다. 그렇지 않으면, 지원 팀은 스토어 버전과 후속 릴리스에서 변경된 내용을 구분하지 못합니다. 이 공간에서 하나의 옵션은 Capgo입니다. 이 옵션은 signed web bundles를 Capacitor 앱에 배포하고, 업데이트 전달과 관련된 버전 기록, 로그, 롤백 데이터를 유지합니다.
자동화는 실제 릴리스 모델을 반영할 때 가장 잘 작동합니다. 팀이 지속적으로 릴리스를 하는 경우, 노트도 지속적으로 생성되어야 하며, 검토를 거친 후에 배포되어야 합니다.
롤백 및 규정 준수에 대한 기업급 노트
기업급 릴리스 노트는 단순한 공개 업데이트만 아니라, 감사 자료, 지원 증거, 사고 참조, 운영 제어 증거로 사용될 수 있습니다.
이것은 노트 작성 방식에 영향을 줍니다. brevity는 여전히 중요하지만, traceability가 더 중요합니다.

감사 자료를 위한 작성, 발표를 위한 작성
공개된 노트는 "계정 복구가 향상되었습니다." 라고 말할 수 있습니다. 기업 릴리스 레코드도 버전, 릴리스 날짜, Approver, 관련 티켓, 위험 분류, 영향을 받은 시스템 및 운영 지침과 같은 정보를 보존해야 합니다.
그것은 모든 독자에게 모든 것을 표시하는 것은 아님을 의미합니다. 그것은 버전화된 레코드에 여러 단계의 세부 정보를 저장하는 것입니다. 공개 요약이 위에 있습니다. 내부 증거가 아래에 있습니다.
규제 부문에 속하는 팀의 경우 유용한 기준은 다음과 같습니다:
- 불변 릴리스 기록
- 이름이 지정된 소유자 및 Approver
- 연결된 구현 레코드
- 배송된, 롤백된, 또는 대체된 릴리스에 대한 명확한 상태
- 긴급 변경 및 핫픽스에 대한 별도의 처리
롤백 노트는 자신의 형식이 필요합니다.
롤백 통지는 중재가 발생하는 동안 자주 임의로 이루어집니다. 그건 위험합니다. 롤백 노트는 첫 번째 등급의 릴리스 아티팩트여야 합니다.
단축된 구조를 사용하십시오:
| Field | 예시 콘텐츠 |
|---|---|
| 롤백 릴리스 | 버전 또는 업데이트 식별자 |
| 이유 | 사용자에게 보이는 문제, 안정성 문제, 호환성 문제 |
| 영역 | 페이지/영역: 지원 / 프리미엄 지원 페이지 또는 지원 섹션. 역할: 섹션 또는 페이지 제목. 표시되는 곳: 페이지 support-policy.astro. 메시지 키 `support_policy_scope_title` (지원 정책 범위 제목). |
| 영향을 받은 사람 | 액션 |
| 팀이 무엇을 했나요 | 현재 상태 |
| 되돌려 받았습니다, 중단, 재배포, 모니터링 중입니다. 사용자 지침 | 사용자 또는 관리자가 해야 할 일 |
롤백 메시지는 항상 정보가 없는 사과문처럼 보이지 않도록 하여야 합니다. 변경 사항이 롤백된 이유를 명확하게 설명하고 롤백이 발생한 사실을 숨기지 않도록 하여야 합니다. 앱이 Live Update를 지원하는 경우, 롤백 제어는 릴리스 히스토리와 배포 채널과 밀접하게 연결되어야 합니다. 이 경우, 롤백을 위한 문서화된 프로세스는 릴리스 커뮤니케이션의 일부가 됩니다. Capacitor 업데이트를 위한 롤백 구성 프로세스 릴리스 노트가 변경 사항에 대한 행동을 유도하는지 여부를 측정하는 것이 중요합니다.
릴리스 노트를 통해 사용자가 어떤 행동을 취했는지 알 수 없는 문제가 여전히 많은 팀에서 해결되지 않은 상태입니다.
변경된 노트의 동작을 측정하십시오
이 문제는 이 문서에 설명된 CalHEERS 릴리스 노트 문서에서 언급된 바와 같이, 기업 환경에서 더 큰 문제가 됩니다. 릴리스 커뮤니케이션의 노력에 대한 정당성을 제공해야 하기 때문입니다.
실용적인 접근 방법은 다음과 같습니다. 기능 발견:기업 환경에서 이러한 간격은 더 중요합니다. 릴리스 커뮤니케이션은 노력의 정당성을 설명해야 하기 때문입니다.
실제 적용 방법은 간단한 신호 집합을 정의하는 것입니다.
- 기능 발견: 사용자가 변경된 워크플로우를 열거나 사용했는지 여부를 확인했습니다.
- 지원 영향: 영향받은 이슈에 대한 질문이 감소했습니까?
- 관리자 행동: 대상 계정에서 요청된 작업을 완료했습니까?
- 사고 명확성: 롤백 또는 단계적 배포 중에 지원이 참고 자료로 사용했습니까?
완벽한 Attribution을 얻을 수 없다는 것은 괜찮습니다. 목표는 릴리스 노트를 정적 문서로 다루지 않고 운영적 레버로 다루는 것입니다.
팀이 자주 업데이트를 배포하는 Capacitor 앱이 있다면 Capgo 컨트리뷰션을 통해 Capgo에 PR을 제출하는 방법입니다.