Files
calctext/_bmad-output/implementation-artifacts/16-3-changelog-whats-new-panel.md
2026-03-16 19:54:53 -04:00

42 lines
1.7 KiB
Markdown

---
epic: 16
story: 16.3
title: "Changelog / \"What's New\" Panel"
status: draft
---
## Epic 16 — Analytics, Feedback & Iteration
**Goal:** Learn from usage to improve CalcPad while respecting user privacy.
### Story 16.3: Changelog / "What's New" Panel
As a CalcPad user,
I want to see what changed after an update,
So that I can discover new features and understand improvements without checking external release notes.
**Acceptance Criteria:**
**Given** CalcPad has been updated to a new version
**When** the user opens the application for the first time after the update
**Then** a "What's New" panel is displayed highlighting the key changes in the new version
**And** each change includes a brief description and, where relevant, a concrete example (e.g., "New: Stock lookups -- try `AAPL price`")
**Given** the "What's New" panel is displayed
**When** the user clicks "Dismiss" or clicks outside the panel
**Then** the panel closes and does not reappear for the same version
**Given** the user wants to review past changelogs
**When** they navigate to Help > What's New
**Then** the current version's changelog is shown
**And** previous versions' changelogs are accessible via a scrollable history or version dropdown
**Given** a minor patch update (e.g., 1.2.3 to 1.2.4) with only bug fixes
**When** the user opens CalcPad after the update
**Then** the "What's New" panel is shown only if there are user-facing changes
**And** if there are no user-facing changes, the panel is not shown and the changelog is silently updated in Help > What's New
**Given** the "What's New" panel content
**When** it is authored for a release
**Then** entries are categorized as "New," "Improved," or "Fixed"
**And** the content is localized into all supported languages (per Story 14.5)