Context
lib/tools.ts declares three nav groups — engines, spec, learn — and learn contains only external links (MDN, tc39). The site has four strong interactive tools and no prose that explains why any of them matters. The embed widgets (/embed/playground, /embed/bytecode, with oEmbed) were built precisely so explanatory writing could carry live output, and nothing on the site uses them.
Proposal
- A
/learn index plus short, self-contained explainers, each built around a live embed rather than a screenshot:
- Why
[] == ![] is true (links into /equality).
- What a hidden class is and how property order changes it (links into the
--trace-maps visualizer once it exists).
- How the same function looks in Ignition, Sparkplug, Maglev and TurboFan (links into
/v8-pipeline).
- What an inline cache is and how it degrades.
- MDX or plain TSX pages — no CMS.
- Cross-link from each tool to the explainer that covers it, and add the pages to the sitemap.
Acceptance criteria
- Each explainer embeds live output produced by the site itself.
- The
learn nav group holds internal entries.
- Pages are statically rendered and indexed in the sitemap.
Context
lib/tools.tsdeclares three nav groups —engines,spec,learn— andlearncontains only external links (MDN, tc39). The site has four strong interactive tools and no prose that explains why any of them matters. The embed widgets (/embed/playground,/embed/bytecode, with oEmbed) were built precisely so explanatory writing could carry live output, and nothing on the site uses them.Proposal
/learnindex plus short, self-contained explainers, each built around a live embed rather than a screenshot:[] == ![]istrue(links into/equality).--trace-mapsvisualizer once it exists)./v8-pipeline).Acceptance criteria
learnnav group holds internal entries.