Static Sites, Dynamic microservices, & Azure: How we built Microsoft Docs and Learn
summary
Builds Microsoft Docs and Learn as a JAMstack system using Markdown, Liquid templates and DocFX, hosted on GitHub with HTML fragments in Azure Blob Storage, served through Akamai CDN and backed by microservices (Azure Search, Cosmos DB, auth). It migrates ~45M legacy pages into ~2,000 public repos, supports 65+ languages, uses GitHub PRs/issues and utterances for community edits, and claims >100M page views/month, ~4x faster load times and multi‑million dollar cost savings.
AI-written summary · about
chapters (36)
- 0:00Introduction
- 2:02Why do we care
- 10:31Demo
- 17:49Architecture
- 24:33GitHub and build
- 25:46Customer experience
- 26:41Scaleout model
- 29:29Chrome from content
- 31:00DevOps
- 31:57Content
- 32:15Localization
- 33:29Docs on GitHub
- 34:31API Reference
- 36:45Source vs Packages
- 38:09APIs Everywhere
- 39:16API Browser Demo
- 40:03Collections
- 40:42SystemString
- 41:39DotNet
- 42:00Azure CLI
- 44:29REST API
- 44:40REST Documentation
- 44:53Postman
- 45:32Reimagining the learning experience
- 46:42Learning by doing
- 48:15Information Architects
- 49:15Coding
- 50:10Microservices
- 50:30Dynamic Services
- 50:45Demos
- 50:55Demo Learning Path
- 54:51Azure Resource Manager
- 55:07What we learned
- 55:20Why GitHub is revolutionary
- 58:34Culture change at Microsoft
- 59:21Resources
related talks
01h 23mMarkdown Madness: Static Sites for Fun & Profit
30mBuild Faster, Better Apps with SSG, Headless CMS & Azure Static Web Apps
35mHosting Single Page Apps in Azure
26mJAMStackin’
36mOn JAMstack Architectures
52mBACK to the Future: Static Blogs and Websites with Jekyll
16mAzure cloud for the web frontend developers
55mA Little Story About A Big Bang Redesign