Interactive Documentation at Scale Using MDX & Next.js
summary
Uses MDX and Next.js to render docs for 10+ products and 750+ guides, serving millions of views, and shows concrete components—tabs, enhanced fenced code blocks, hands‑on lab embed, Sentinel playground—that actually work in production. Introduces Next MDX Remote to serialize MDX from APIs, syncs MDX into a database on release tags, and uses ISR-backed versioning to avoid repo bloat while making old versions available on demand. Builders separate content from site code and report faster builds and manageable git size.
AI-written summary · about
chapters (4)
related talks
23mThe Legendary Fountain of Truth: Componentize Your Documentation!
28mBeyond Skeuomorphic Markdown
08mNext for Next.js
20mPlaying with Interactive Documentation
06mMake amazing docs, faster with StackBlitz and Next.js
20mDocs at Weaveworks DX from open source to SaaS and beyond
21mWriting documentations that don't suck!
05mDocs as Part of the Product: Open Source Technical Documentation at Scale