Adopting Docs-as-Code: From Hackathon to Production

Sysdig transitioned its documentation process to a docs-as-code model, inspired by its yearly Hackathons, to enhance collaboration and efficiency. This shift involved moving from various documentation tools, such as Zendesk and Confluence, which had limitations in version control, branding, and collaboration, to a more integrated system using GitHub and the Hugo static site generator. The transition was facilitated by developing an in-house conversion tool to migrate XML content to markdown, enabling easier collaboration among developers, product managers, and support teams. The new system allows for automated publishing and documentation development, ensuring synchronization with source code changes. This approach led to a significant increase in contributors and a reduction in deployment time, fostering shared ownership and improving documentation quality to support customer success.