READMEs and the migration guide #62

Parent

Spec: #33 (Baseline release). Section numbers refer to its Implementation Decisions.

What to build

A go-rod user reads one page and knows exactly what to change and what still does not work; a newcomer reads the README in English or Chinese and knows what wand is, where it runs, which Chrome it targets and how to trust it. Spec section 18; ticket #15, #18, #32.

Acceptance criteria

• English and Chinese READMEs: the lineage paragraph (two lines linking go-rod's repository and NOTICE, one sentence linking the migration guide, no link to any Release); a Roadmap section (the baseline, then API modernization and Stealth as planned, no dates); the Scorecard badge; the image verification line; a link to versions.json; the Support tier table and the Support window; the Go floor with the Domestic platform build paths (system Go on openEuler 24.03, cross-compile or tarball elsewhere, new-world loong64 only); a Browser resolution summary with the environment variables and the known domestic browser paths; install and quick start on the new module path; container image usage.
• docs/migrating-from-go-rod.md: the import prefix swap; gson to lazyjson; the removed assets package and seven utils helpers; the two cmd/ commands; the browser cache location; leakless to Orphan guard and the Leakless() semantics; User mode's profile directory; -rod= to -wand= and WAND_BROWSER_*; the second ErrCtxDestroyed message; the container image rename and multi-arch tag; a Known limitations section listing omitempty booleans, OOPIF Element.Frame() / ControlURL(), Ubuntu 24.04 NoSandbox, Alpine Chromium, no managed download on windows/arm64, loong64 and musl, and new-Headless semantics.
• Package READMEs consistent with the above; no dead links.

Blocked by

• Harvest: launcher and input (rod #1221, #1176, #1233, #1220) #51 (Harvest: launcher and input (rod #1221, #1176, #1233, #1220))
• Test harness: browser resolution in TestMain, WAND_BROWSER_* selection, no flaky skips #53 (Test harness: browser resolution in TestMain, WAND_BROWSER_* selection, no flaky skips)
• Container image and the in-container Gate #55 (Container image and the in-container Gate)
• Security Gates, Dependabot and Scorecard #56 (Security Gates, Dependabot and Scorecard)