Manager, Documentation Engineering

Details

ClickHouse is an open-source company building a fast, resource-efficient real-time data platform. The Documentation team is deeply technical and independently uses ClickHouse products, reads source code, tests behavior, and writes accurate documentation. The team also owns the documentation infrastructure as a critical, production-facing service, including its availability, performance, reliability, and continuous improvement.

This is a hands-on player-coach role leading a small, highly technical team while contributing directly to technical documentation and the engineering of the documentation website and its supporting infrastructure.

Responsibilities

• Lead the execution, development, and prioritization of the Docs Engineering team while remaining hands-on in technical writing and engineering.
• Own the reliability, availability, performance, and technical evolution of the ClickHouse documentation website.
• Research, develop, and write technical documentation by understanding product functionality through source code, experimentation, testing, and collaboration with Engineering and Product.
• Define and execute documentation strategy in partnership with Engineering, Product, Product Marketing, Learning, Support, Growth, and the open-source community.
• Improve docs-as-code contribution workflows so engineers, product managers, the Docs team, and external contributors can create and maintain documentation efficiently.
• Review documentation pull requests, triage issues, unblock contributors, and directly author or substantially improve high-impact content.
• Build and maintain the documentation site's infrastructure, publishing systems, automation, CI workflows, monitoring, and quality checks.
• Establish organization-wide workflows, safeguards, and quality standards for documentation generated or maintained with AI agents.
• Work with teams across ClickHouse to understand their needs, translate them into practical documentation processes, coach authors, and resolve competing priorities.
• Ensure documentation remains accurate, comprehensive, discoverable, and aligned with product development.
• Make documentation a driver of product adoption and growth by helping users discover ClickHouse, get started quickly, and convert into active users through an intuitive documentation experience.

Requirements

• Prior experience managing and developing a technical team.
• A hands-on leadership style and comfort moving between people management, technical writing, software engineering, process design, and day-to-day execution.
• Strong technical writing skills and experience independently producing documentation for complex software products.
• Ability to investigate functionality, read and understand source code, validate product behavior, and translate findings into clear, accurate documentation for developers.
• Experience building, maintaining, and operating production websites, with a strong understanding of reliability, availability, performance, monitoring, and operational best practices.
• Strong experience with documentation-as-code workflows and modern software-development practices.
• Comfort working with Astro, TypeScript/JavaScript, GitHub Actions, pull-request workflows, and CI pipelines.
• Experience designing or operating content quality systems, automation, and contributor workflows at scale.
• Experience working productively with coding agents and applying AI to documentation without sacrificing accuracy, consistency, or trust.
• Excellent cross-functional communication skills and the ability to draw out requirements, influence technical and product partners, set clear standards, and make progress in ambiguous situations.
• Comfort operating in a fast-paced, high-expectation environment.

Nice to Have

• Experience with ClickHouse or similar database technologies.
• Experience contributing to or maintaining an open-source project.

Benefits

• Flexible work environment at a globally distributed, remote-friendly company operating in more than 25 countries.
• Employer contributions toward healthcare.
• Stock options for every new team member.
• Flexible time off in the United States and generous entitlement in other countries.
• USD 500 home office setup allowance for remote employees.
• Opportunities to engage with colleagues at company-wide global gatherings.

ClickHouse provides equal employment opportunities to all employees and applicants and prohibits discrimination and harassment based on legally protected characteristics.