Skip to content

Clarify upgrade log: plain-language phases and ASCII errors#421

Merged
ppXD merged 1 commit into
mainfrom
fix-upgrade-log-clarity
Jun 5, 2026
Merged

Clarify upgrade log: plain-language phases and ASCII errors#421
ppXD merged 1 commit into
mainfrom
fix-upgrade-log-clarity

Conversation

@ppXD

@ppXD ppXD commented Jun 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

Operator feedback on the web-surfaced Windows upgrade log (1.8.15):

  • Plain-language phases — replace the opaque "Phase A / Phase B" jargon in the raw upgrade log with what's actually happening: Preparing upgrade to <version>, Installing <version>, Upgrade complete. The structured event phase field stays A/B (the events-parity data contract); only the human-readable log text changes. The web UI relabels the timeline [A]/[B][Prep]/[Install] (SquidWeb PR).
  • No more mojibake in error lines — exception messages on a non-Latin OS (e.g. Chinese Windows) were localized and rendered as garbage in the web log (a DNS failure showed up as ʹ�á�...). Force the thread UI culture to en-US so .NET errors come through in English, and ASCII-sanitize every Append-UpgradeLog line as a belt-and-braces guarantee.

Test plan

  • 707 upgrade unit tests green; new drift pins for the reworded banners + the en-US-culture / ASCII-sanitize
  • Script still pure ASCII (the comment that introduced the only non-ASCII char was fixed)
  • Windows E2E (dispatched on this branch) — the production .ps1 runs end-to-end with the reworded log + culture set

Operator feedback on the web-surfaced Windows upgrade log:

- Replace "Phase A/B" jargon with plain language: "Preparing upgrade to X",
  "Installing X", "Upgrade complete". The structured event phase field stays
  'A'/'B' (the events-parity contract); only the human-readable log text changes.
- Exception messages on a non-Latin OS (e.g. Chinese Windows) were localized and
  rendered as mojibake in the web log. Force the thread UI culture to en-US so
  .NET errors come through in English, and ASCII-sanitize every log line as a
  belt-and-braces guarantee.
@ppXD
ppXD merged commit 39bbca4 into main Jun 5, 2026
17 checks passed
@ppXD
ppXD deleted the fix-upgrade-log-clarity branch June 5, 2026 00:33
@ppXD ppXD added this to the 1.8.15 milestone Jun 5, 2026
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