Adopting Docs-as-Code at Pinterest

Pinterest Engineering developed PDocs, an internal documentation system based on docs-as-code principles, to solve persistent documentation quality and discoverability issues. The system allows teams to write documentation in Markdown alongside their code, uses automated static site generation, and integrates with GitHub workflows. Key features include a centralized documentation site, project-centric UI design, GenAI integration for enhanced search, and tools for converting existing wiki content. The implementation resulted in 140+ documentation projects across 60+ repositories and significantly improved developer satisfaction with documentation tools.