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

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
Contributor

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

@peholmst peholmst added the target/v25.3 Automatically cherry-pick to the v25.3 branch label Sep 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

target/v25.3 Automatically cherry-pick to the v25.3 branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants