Skip to content

1.xx maturity checkpoint (1.51)

Deliberate “where we are” release for the 1.line after the post-1.40 arc (1.41…1.50). Not a soft 2.00.

Latest long-horizon (1.78): prefer field harden / pause; OSK/IME stays experimental; not 2.00.

Latest mid-horizon (1.60): re-audit; keyboard arc 1.70…1.77 shipped afterward.

Related: compatibility-1xx.md · stable-api.md · upgrade-notes.md · ROADMAP.md · Gallery Pitfalls.

Verdict

Question Answer (1.51)
Ready for LoB apps on stable surface? Yes — prefer stable-api.md + examples/gallery-shell
Start 2.00? No — stay on 1.xx
Posture for the next slices? Prefer harden / field polish / docs over inventing new control families
Experimental still movable? Yes — Media, ConnectedAnimation, niche charts, Snap Layouts, TabView tear-out (1.37 defer)

Audit snapshot (1.51)

Check Result
Recipe + ROADMAP docs/*.md links 0 broken
Gallery catalog pages ~184 (controls + recipe hubs)
Public component docs ~208 public / ~219 generated pages
Stable map vs Gallery Stable list remains the product contract; Gallery also demos experimental — treat unlisted public types as experimental (stable-api.md)
Starter path examples/gallery-shell (1.50) first; nav-settings for hand-wired StandardWindow

No silent Theme / shell / stable renames since the 1.40 freeze. Additive APIs in 1.41…1.50 (clipboard, TwoPaneView, contrast helpers, icon micro-motion, NavigationWindow pageModule, …) stay compatible under the freeze rules.

LTS-style guidance (for a while)

Until a later checkpoint says otherwise:

  1. Ship on stable — Theme tokens, shells, and types named on stable-api.md.
  2. Copy gallery-shell, not the full Gallery tree — examples/gallery-shell/README.md keep-vs-delete.
  3. Harden first — field P0s (portal / DPI / tray / WebView2 / packaging) beat new surfaces; 1.52 shipped CI/docs harden when no field P0s were open.
  4. Promote only in named minors — update stable-api changelog; do not silently flip experimental → stable.
  5. Do not draft 2.00 until several breaking needs pile up — ROADMAP.md far-future section.

Deferred (unchanged intent)

Still experimental / won’t-promote-for-now (see stable-api 1.37 defer):

  • MediaPlayerElement (optional Multimedia — deferred 1.67)
  • ConnectedAnimation / entrance / theme transition helpers
  • TabView tear-out
  • Niche charts beyond the stable six
  • WebView2 advanced Environment / multi-profile
  • Snap Layouts / battery / online / screens / recent-docs helpers

Scheduled follow-ups remain on the roadmap parking lot — 1.78 closed the long-horizon arc; prefer field P0s over new surfaces.

Consumer checklist

Use upgrade-notes.md for 1.50 → 1.51. Short form:

  • [ ] Pin / reinstall QWINUI3_VERSION 1.51
  • [ ] Skim stable-api changelog rows 1.49…1.51
  • [ ] Prefer examples/gallery-shell if starting a new app shell
  • [ ] Rebuild Release; optional Gallery --smoke