Repository navigation
Windows UI redesign: Update user documentation and assess release readiness #134
Description
한국어 — 사용자 문서 갱신과 릴리즈 준비 상태 평가
화면 시안
이미지를 클릭하면 크게 볼 수 있습니다. 순서도나 구현된 Windows 앱 스크린샷이 아닌 UI 화면 제안입니다. 이미지는 합성이고 수치는 설명용 예시입니다. 주변 조작 요소는 전체 계획의 맥락이며 이번 작업에서는 아래 범위만 구현합니다. 현재 빌드의 실제 변경 전·후 화면이라는 뜻이 아닙니다. 검증 작업의 그림은 검사 대상을 설명할 뿐 새 제품 UI나 검사 통과 증거가 아닙니다.
이번 작업의 목표
검증된 실제 앱 동작을 설명하고 구현과 별개로 릴리즈 범위를 결정합니다.
작업 묶음: #115. 전체 설계와 반드시 유지할 기존 동작: #110.
이번에 변경할 것
-
실제 패널·탐색·테마·선택·단축키·A/B 범위와 승인한 화면 예시로 USER_GUIDE를 갱신합니다.
-
변경 이력·Store 문구를 정확히 유지하고 각 글머리 항목·문단을 수동 줄바꿈 없는 하나의 논리적 줄로 씁니다.
-
핵심 검증 증거·한계·호환성 정보를 모으고 검사가 통과한 다음에만 릴리즈·버전 방향을 요청합니다.
이번 작업에서 하지 않을 것
릴리즈 게시, 버전 사전 선택, 구현되지 않은 기능 홍보.
완료 조건
-
문서가 초기 목업이 아니라 실제 구현 UI와 레이블에 맞습니다.
-
핵심 작업 모두에 실제 검증 증거와 알려진 한계가 기록됩니다.
-
계획·준비 상태 평가만으로 태그·Store 제출·자동 major 증가가 실행되지 않습니다.
먼저 함께 결정할 질문
새 사용 흐름을 이해하는 데 어떤 설명서 예시가 가장 도움이 될까요?
검토 상태: 논의 대기. 구현 전에 사용자가 합의한 선택과 수정된 시안을 이 이슈에 기록합니다. 다른 작업 검토, 목업 조작, 이슈 등록은 이 작업의 승인이 아닙니다. 다음 작업으로 자동 진행하지 않습니다.
구현·검증 규칙
Windows MFC Viewer/Comparator만 대상입니다. #110과 AGENTS.md를 따르고 최신 origin/master에서 해당 작업용 브랜치를 시작합니다. 관계없는 변경은 보존하고 기존 명령·렌더링 경로를 재사용합니다. 영향을 받는 실제 앱 작업 흐름을 검증하고 공통 코드 또는 릴리즈에 민감한 변경에는 관련 로컬 핵심 테스트·빌드를 실행합니다. 실패는 수정하고 해당 검사를 반복한 뒤 PR/커밋, 실제 증거와 한계를 기록합니다. 목업 검사는 실제 Windows 앱 검증이 아닙니다. 이 작업은 릴리즈 태그·Store 게시·버전 증가를 승인하지 않습니다.
English original — 영어 원문 펼치기
Proposed UI screen
Click the image for full-size details. This is a UI screen proposal, not a flowchart or a screenshot of an implemented native build. Images are synthetic and values are illustrative. Surrounding controls are roadmap context; implement only this job's changes below. This is not a literal before/after claim about the current build.
One job, one outcome
Explain the verified native behavior and decide release scope separately from implementation.
Coordination epic: #115. Overall design and unchanged behavior contracts: #110.
Changes in this job
-
Update USER_GUIDE with actual panels/navigation/themes/selection/shortcuts/A-B scope and approved screen examples.
-
Keep changelog/Store wording accurate and each bullet/paragraph on one logical line.
-
Gather core evidence, limitations and compatibility notes; request release/version direction only after checks pass.
Explicitly outside this job
Publishing a release, selecting a version in advance, marketing an unimplemented feature.
Done when
-
Documentation matches the implemented UI and labels rather than the initial mockup.
-
All core jobs have real verification evidence and known limitations recorded.
-
No tag, Store submission or automatic major bump is triggered by planning/readiness.
Discuss this screen first
Which guide examples would help you understand the new workflow most?
Review status: awaiting discussion. Record the user's agreed choices and any revised picture before implementing this job. Reviewing another job, interacting with the mockup, or registering this issue does not approve this one. Do not automatically proceed to the next job.
Implementation and verification rules
Windows MFC Viewer/Comparator only. Follow #110 and AGENTS.md, start a focused branch from the current origin/master, preserve unrelated changes, and reuse existing command/rendering paths. Verify the affected native workflows and run the relevant local core tests/builds for shared or release-sensitive changes. Fix failures and repeat the affected checks; record PR/commit, actual evidence and limitations. Mockup checks are not native-app verification. This job does not authorize a release tag, Store publication or a version bump.
Activity