docs: sell the standards, type-safety and defaults case, and give the landing page a narrative spine - #1393
Merged
Merged
Conversation
The site sold no-build and web components but never said the framework leans on web standards as a stance, never claimed full-stack type safety on a marketing page, never cited a production precedent for shipping without a bundler, and never mentioned the agent skill or that the scaffold's stack is a default rather than a dependency. Grid geometry decided the placement: the home bento and both /why-webjs grids paint an empty cell in the border colour when the entry count goes odd, so new points either replaced a card body or arrived in pairs.
The page listed seven true things and none of them set up the next, so nothing on it earned a scroll. The sections are unchanged; each lede now opens by picking up what the previous section closed on, turning the page into one argument that runs from the trade every framework made to the command that starts an app. "Server action & SSR page" became "Nothing is compiled away", since the code windows already caption themselves and the h2 was the only place the hand-off could live. "Start where you are" had no lede at all.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #1392
Two commits on
website/only. No framework source touched.1. The claims the site was not making
Several things that are true of WebJs and that a reader decides on were stated nowhere on a marketing page.
Zero build stepcard asserted the bet and cited nothing. It now notes Rails has shipped its default frontend without a bundler since Rails 7 in 2021. Kept to one clause on purpose:articles/no-build-javascript-framework.mdowns that keyword, andwebsite/AGENTS.mdforbids two pages chasing the same one./docs/typescriptand in a blog post, absent from all three marketing pages. Now on the home bento (the RPC card becameServer actions, fully typed), in the code-windows lede, as a card on/why-webjs, and as a FAQ entry on/what-is-webjs./why-webjslisted what a scaffolded app arrives with and never said any of it was replaceable, which is exactly the objection that grid raises. A paragraph under the grid now says so, and the home templates section names the stack (light DOM, Tailwind, Drizzle, modules layout, tokens, the agent skill)./docs/ai-first, never sold on the pitch page. Now a card inARRIVES.2. A narrative spine for the landing page
The page listed seven true things and none of them set up the next, so nothing on it earned a scroll. Sections and order are unchanged; each lede now opens by picking up what the previous section closed on.
Server action & SSR page)The opening beat credits the trade rather than mocking it, matching the register
/why-webjsalready uses for the same move.Two things a future editor needs
Grid parity. Three grids here paint an empty cell in the grid's own border colour when the entry count goes odd (
gap-pxoverbg-border). That is why type safety folded into the existing bento card instead of becoming a seventh, and whyARRIVESwent 4 to 6 rather than to 5. A comment aboveARRIVESrecords it.The spine is fragile in a way no test catches. The hand-off lives in the first sentence of each lede, so rewriting one in isolation silently reverts the page to a spec sheet. A comment above
STATSinpage.tsrecords the chain and says so.Verification
webjs typecheckclean,webjs checkclean,webjs test --server471/471. Booted locally and read end to end.