---
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)
