We rebuilt Cloudflare's developer documentation - here's what we learned

What this post added

This post details the migration of Cloudflare's developer documentation website from Gatsby to Hugo and its convergence onto a single Cloudflare Pages instance. Key technical contributions include: the development of a migration script utilizing AST parsing (mdast-util-from-markdown, mdast-util-to-markdown, astray) to convert MDX to standard Markdown, the implementation of a code formatter script using Prettier to ensure code snippet validity and syntax correctness, and the creation of a Makefile to orchestrate the migration process. The migration resulted in over one million automated changes across nearly 5,000 files.