Skip to content

docs: add sov-undecided intro under Modernization Toolkit#5832

Draft
mvysny wants to merge 2 commits into
mainfrom
docs/swing-on-vaadin-intro
Draft

docs: add sov-undecided intro under Modernization Toolkit#5832
mvysny wants to merge 2 commits into
mainfrom
docs/swing-on-vaadin-intro

Conversation

@mvysny

@mvysny mvysny commented Jul 23, 2026

Copy link
Copy Markdown
Member

What

Adds an introductory page for sov-undecided — a Swing-to-Vaadin migration approach based on import-swap: rewrite javax.swing.* imports to vaadinx.swing.*, recompile against a Vaadin-backed emulation of the Swing API, and run the result as a real Vaadin web app.

Placed under Modernization Toolkit (order: 150, right after SwingBridge), and added to that section's "toolkit contains" list.

The page is a concise introduction to the concept and what a migration looks like — no reference tables, no install steps.

Page contents

  • What it is (migration bridge, not a permanent target)
  • A [NOTE] distinguishing it from SwingBridge (SwingBridge streams the real Swing app from the server; sov recompiles into a real Vaadin app)
  • How it works (peers, JDK data types unchanged, warn-and-default)
  • The import-swap before/after, as a two-column table where only the imports differ
  • The four-stage migration arc
  • When to use it + the trade-off vs. a spec-driven rewrite
  • Out of scope and requirements (JDK 24+, Vaadin 25 + @Push)

⚠️ Before merging

  • Decide the public name. sov-undecided is a placeholder used throughout (title, page-title, meta-description, body). A header comment in the .adoc lists every spot to update.
  • Confirm whether a commercial banner (section-nav: commercial) is needed — omitted for now, unlike sibling toolkit pages.
  • Add a since: version badge once released — omitted for now.

No download or GitHub links are included, since the project isn't public yet.

🤖 Generated with Claude Code

Introduce the concept of migrating a Swing desktop app to Vaadin via
import-swap (recompiling against a Vaadin emulation of the Swing API),
as a new page under the Modernization Toolkit, alongside SwingBridge.

The product name is undecided, so the placeholder "sov-undecided" is used
throughout with a header comment listing every spot to update once a name
is chosen. No download or GitHub links, since the project isn't public yet.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@cla-assistant

cla-assistant Bot commented Jul 23, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@github-actions

github-actions Bot commented Jul 23, 2026

Copy link
Copy Markdown

Preview Deployment

This PR has been deployed for preview.

URL: https://docs-preview-pr-5832.fly.dev

Changed pages

Added content is highlighted in green; removed content is marked in red on each page.

Built from 858923b

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