# 릴리즈 노트 스타일

## 문서 목표
- 범주: 릴리즈와 운영 신뢰
- 우선 사용자: 운영자 + 메인테이너
- 우선 채널: Windows + Web + Android + VPS
- 다루는 장면: 릴리즈 노트 스타일을 통해 산출물, 다운로드, 관찰성, 복구를 하나의 공개 표면으로 묶는 구조

## 왜 중요한가
- 릴리즈 노트 스타일은 반복 사용 단계의 체감 시간을 줄이는 핵심 장면이다.
- 이 문서는 기능 추가보다 사용자가 헷갈리지 않고 바로 행동하게 만드는 기준을 다룬다.
- 업무형 소통과 친근한 소통 모두에서 과도한 설명보다 짧은 실행을 우선한다.

## UX 원칙
- 한 화면에서 사용자가 지금 해야 할 행동을 하나만 강조한다.
- 상태 설명은 기술 용어보다 사용자가 잃을 수 있는 것과 복구 가능성을 먼저 말한다.
- 목록, 검색, 보관, 내 공간의 역할을 섞지 않는다.
- 데스크톱과 모바일의 차이는 표면만 달라지고 정신 모델은 유지한다.

## 표준 흐름
1. 사용자는 릴리즈 노트 스타일이 필요한 순간에 가장 가까운 표면에서 진입한다.
2. 시스템은 맥락을 잃지 않도록 현재 대화, 최근 작업, 저장된 초안을 유지한다.
3. 사용자는 최소 입력으로 필요한 행동을 끝내고 다음 대화로 이동한다.
4. 완료 후에는 다시 찾기, 복귀, 후속조치까지 이어질 수 있어야 한다.

## 현재 산출물 기준 비판적 시각
- 현재 릴리즈 표면은 정리 중이며, 다운로드 호스트와 원격 Releases의 정합성은 더 강화해야 한다.
- 문서상 원칙은 충분하지만 자동화와 무결성 검증, 공개 상태 표면은 아직 진행형이다.
- 따라서 릴리즈 노트 스타일은 단순 기능 제안이 아니라 현재 제품이 아직 불완전하게 느껴지는 지점을 메우는 문서로 본다.

## 측정과 릴리즈 게이트
- 첫 성공까지 걸리는 시간과 중간 이탈률을 함께 본다.
- 사용자가 릴리즈 노트 스타일 흐름을 끝낸 뒤 다시 되돌아오지 않아도 되는 비율을 본다.
- 릴리즈 전에는 빈 상태, 오류 상태, 복구 상태까지 최소 한 번씩 수동 점검한다.

## 금지 패턴
- 화면을 설명 카드로 채우고 실제 행동은 뒤로 미루는 구성
- 필터, 내비게이션, 설정을 같은 계층에서 경쟁시키는 구성
- 사용자 잘못처럼 보이게 만드는 모호한 오류 카피

## 구현 연결 메모
- 관련 상위 문서: 문서/README.md, 문서/31-user-review-log-and-experience-scorecard.md, 문서/96-experience-gap-implementation-backlog.md
- 이 문서는 기획과 QA 기준을 함께 포함하므로 실제 구현 시 UI, API, 운영 문서와 같이 갱신한다.
