How we launched docs.github.com
Jul 2, 2020Sarah Schneider

Summary
This post details the migration of GitHub's documentation from static Jekyll-based sites to a new, custom dynamic backend built with Node.js and Express. Key technical achievements include eliminating static site builds for faster deploys, implementing dynamic version rendering to replace backporting, integrating Fastly CDN for global caching, and improving search with Algolia. The post also outlines the refactoring of content organization to a product-centric structure (`content/<product>/<category>/<article>`) and the development of pipelines for autogenerating REST API docs from OpenAPI schemas and GraphQL API docs from schemas using a custom JavaScript script. Content migration was scripted based on a detailed mapping spreadsheet.