moonming opened a new pull request, #2073: URL: https://github.com/apache/apisix-website/pull/2073
## What Serve the site's landing page (`/` and `/zh/`) from a small static, zero-JS build, while **every other URL on the site is still produced by Docusaurus exactly as today**. This is the first and smallest wave of an incremental migration away from the four stitched-together Docusaurus SPAs. Full context and the site-wide plan live in `next/MIGRATION.md`. ## Why - The landing page currently ships ~200 KB gzip of framework JS + hydration for a page with no interactive state; the static version is ~5 KB. - Cross-workspace client-side routing periodically resolves to the SPA 404 after deploys. - The current toolchain is pinned to Node 16 (EOL) and Docusaurus 2.0-beta. ## How - `next/` is a self-contained static build of the landing page. It has **no dependency on the synced project docs**, so its CI step skips the content sync and finishes in ~2 s. - `deploy.yml` gains three steps that run **after** the existing Docusaurus build, canonical check, and sitemap steps — so the Node 22 switch never touches the Node 16 Docusaurus toolchain. They build the landing page and overlay exactly `index.html`, `zh/index.html`, and `_astro/` onto `website/build`. Nothing else is modified; `publish_dir`, `.htaccess`, redirects, and the sitemap are untouched. ## Contract & verification Assembled against the current `asf-site` tree and asserted: - index.html page count unchanged (**4306 → 4306**) - `/` and `/zh/` become zero-JS; **every other page is byte-identical** - landing-page `<head>` matches production: title, meta description, canonical, hreflang, Open Graph / Twitter card (incl. `og:image`), and JSON-LD ## Notes for reviewers - This changes the landing page's frontend framework, so it should land only after dev@ discussion and the usual reviews — not as a routine merge. - During the transition, the static landing page and the Docusaurus pages it links to have slightly different header/footer chrome. Subsequent waves (blog, learning center, docs) close that gap; see `next/MIGRATION.md`. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
