Skip to content

docs(start-os): name the installer's Preserve button in the password-reset guides - #3625

Open
stupleb wants to merge 1 commit into
masterfrom
docs/preserve-button-label
Open

docs(start-os): name the installer's Preserve button in the password-reset guides#3625
stupleb wants to merge 1 commit into
masterfrom
docs/preserve-button-label

Conversation

@stupleb

@stupleb stupleb commented Aug 4, 2026

Copy link
Copy Markdown
Member

Both password-reset guides told the user to select Keep my data when choosing a drive. That label does not exist in StartOS.

The drift

The setup wizard's StartOS Data Detected dialog offers Preserve / Overwrite — see projects/start-os/web/setup-wizard/src/app/components/preserve-overwrite.dialog.ts (Preserve at L49 and L86, Overwrite at L53 and L75, the dialog heading at L35). "Keep my data" appears nowhere in the repo.

This matters more than a typical wording slip: reset-password.md and forgot-password.md are the two pages a locked-out user lands on. A wrong button name hits at the worst possible moment, on a screen where the other button erases their data.

The fix

Both pages now name Preserve, matching the pages that already had it right — installing-startos.md (Install section) and update-040.md (Step 7, Flash Update tab).

The step is also reworded from "When selecting your data drive, select …" to "When prompted, select …": the dialog opens after the data drive has been chosen, not during selection, so the old phrasing folded two screens into one.

Notes

  • Docs-only, no behavior change — so no CHANGELOG.md entry, per the root AGENTS.md rule (which is conditioned on changes that alter user-visible behavior). Independently: start-os/v0.4.0.1 is a cut tag on origin and the changelog's top heading is ## [0.4.0.1], so that line is fully released — an entry would require cutting a new heading and bumping the manifest, which a docs correction does not warrant.
  • Swept the repo for other occurrences of the same drift; there are none. The remaining to keep your data hits are the real product strings in the dialog and drives.page.ts.

Verification

  • mdbook build on the StartOS book — clean.
  • prettier --check on both pages — clean.

…reset guides

Both password-reset guides told the user to select "Keep my data" when
choosing a drive. No such label exists: the setup wizard's StartOS Data
Detected dialog offers Preserve / Overwrite
(web/setup-wizard/src/app/components/preserve-overwrite.dialog.ts). These are
the pages a locked-out user lands on, so the wrong button name hits at the
worst possible moment.

Name Preserve, matching installing-startos.md and update-040.md. That dialog
also opens once the data drive has been chosen rather than during selection,
so the step no longer folds the two screens into one.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant