Manager, Documentation Engineering
About The Position
ClickHouse is seeking a hands-on Documentation Engineering Manager to lead its small, highly technical Docs Engineering team. The role combines people leadership with direct contributions to technical writing and to the engineering of the documentation website and its supporting infrastructure. The Docs team produces technical documentation by independently investigating product behavior, including reading source code, testing, and collaborating with Engineering and Product. It also enables contributions from the company and open-source community while maintaining consistent, discoverable, trustworthy documentation. The manager will own the documentation website as a critical, production-facing part of the product experience, ensuring its reliability, availability, performance, and ongoing technical evolution. The role will define documentation strategy with cross-functional partners, improve contribution processes and quality standards, and help make documentation an effective driver of product adoption and growth. It also includes establishing workflows and safeguards for documentation created or maintained with AI agents.
Requirements
- Prior experience managing and developing a technical team.
- Ability to lead hands-on across people management, technical writing, software engineering, process design, and day-to-day execution.
- Strong technical writing skills and experience independently documenting complex software products for developers.
- Ability to investigate product functionality, read and understand source code, validate product behavior, and explain findings clearly and accurately.
- Experience building, maintaining, and operating production websites, with 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 a thoughtful approach to applying AI to documentation without sacrificing accuracy, consistency, or trust.
- Excellent cross-functional communication skills and ability to elicit requirements, influence technical and product partners, set standards, and make progress in ambiguous situations.
- Comfort operating in a fast-paced, high-expectation environment.
Nice To Haves
- Experience with ClickHouse or similar database technologies.
- Experience contributing to or maintaining an open-source project.
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 investigating 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 for engineers, product managers, the Docs team, and external contributors.
- Review documentation pull requests, triage issues, unblock contributors, and 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 needs, create 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 become active users through an intuitive documentation experience.
Benefits
- Employer contributions toward healthcare.
- Stock options for every new team member.
- Flexible time off in the US and generous time-off entitlement in other countries.
- USD $500 home office setup benefit for remote employees.
- Opportunities to engage with colleagues at company-wide offsites.
Stand Out From the Crowd
Upload your resume and get instant feedback on how well it matches this job.
What This Job Offers
Job Type
Full-time
Career Level
Manager
Education Level
No Education Listed
