Cloudflare

Open source all the way down: Upgrading our developer documentation

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

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