From Brittle to Supple: How Gatsby and MDX Made Our Documentation Smoothly
summary
Claims a concrete migration: migrated two repos into one using Gatsby and MDX, adding gatsby-plugin-mdx, gatsby-plugin-compile-es6-packages, remark autolink headers and a filesystem source to pull component MDX files. It builds component pages that render React examples inline, a props table generator, custom list and code-block components, and MDX with React Live editable code blocks so examples are interactive. The site improves accessibility and reduced CLI commands dramatically and fixes the brittle publish pipeline.
AI-written summary · about
chapters (12)
- 0:00Start
- 0:11AWS Amplify The way to build full stack cloud apps.
- 1:39Cyclocross!
- 2:54Brittle, brittle docs
- 3:15Design System Repo
- 5:56Smoothly inclusive documentation
- 6:26Finding a solution
- 7:48Configuring for MDX
- 9:24Page template
- 10:20Component Props Tables
- 11:19Custom Code Blocks
- 17:03THE BIGGEST REACT CONFERENCE IN THE CLOUD
