Docs as Part of the Product: Open Source Technical Documentation at Scale

on YouTube ↗05m

" summary

Describes how Microsoft swaps out the world’s largest technical docs site by moving MSDN to a GitHub-native system that uses CommonMark markdown, repo-per-product content, and public GitHub issues for feedback; automation handles API extraction, PR validation, SEO and link checks, and sample code generation so humans focus on content; result is improved reliability, measurable contributor attribution from git history, and an active OSS community submitting fixes and samples.

AI-written summary · about

" chapters (5)

1. 0:00Introduction
2. 0:26Key Principles
3. 1:13Community
4. 2:59Feedback
5. 4:04Automation

" related talks

• 39mBecome a Contributor to Microsoft DocsWILLIAM ASSAF · Global Azure Austria 2021
• 20mDocumenting the Web PlatformFlorian Scholz · JetBrains JavaScript Day 2021
• 47mEngineering DocumentationLorna Jane Mitchell · GOTO Copenhagen 2022
• 42mEngineering DocumentationLorna Jane Mitchell · YOW! Melbourne 2022
• 56mEffective Documentation: The Key to Open Source GrowthBolaji Ayodeji · foss-north 2020
• 35mBuilding Docs like Code: Continuous Integration for DocumentationMason Egger · PyCon US 2020
• 59mTransforming your Documentation ProcessRiona MacNamara, Ted Hudek, Zach Corleissen, Leon Barnard, Jon Bulava · Write the Docs North America 2016
• 25mBuilding Docs like Code: Continuous Integration for DocumentationMason Egger · PyOhio 2019