Squarespace's Domains engineering team has adopted the "Docs-as-Code" philosophy to enhance their documentation process by integrating it with their code workflows. This approach streamlines documentation through version control, plain text markup, and continuous deployment, resulting in improved collaboration, reduced friction, and increased documentation quality. The team shares their experiences and practical tips for implementing this effective documentation strategy.
Pinterest faced ongoing challenges with technical documentation quality and discoverability, prompting the adoption of a docs-as-code strategy. This led to the creation of PDocs, an internal documentation system that integrates documentation alongside code, enhances collaboration, and improves discoverability through a centralized platform. Key features include a streamlined UI, version control, and real-time updates to ensure documentation remains relevant and accessible.