Open source all the way down: Upgrading our developer documentation
Jan 8, 2025Kim Jeske, Kian Newman-Hazel, Kody Jackson

Summary
This post details the migration of Cloudflare's developer documentation site from Hugo to Astro/Starlight. The migration involved significant technical work, including the use of Markdown ASTs and the 'astray' utility to transform content structures (e.g., code block front matter to meta attributes). It highlights the benefits of Astro and Starlight, such as enhanced content organization, extensibility, improved development experience with type-checking and linters, and better CSS management. The post also quantifies the migration effort in terms of files changed and lines of code removed, and discusses lessons learned, including the value of community involvement.
More from the Content Management System (CMS) Evolution trail
- EmDash 1.0: the stable CMS with a secure plugin registry
- The Cloudflare Blog – Brought to you by EmDash
- Redirects for AI Training enforces canonical content
- Introducing EmDash — the spiritual successor to WordPress that solves plugin security
- Payload on Workers: a full-fledged CMS, running entirely on Cloudflare’s stack