Prior experience managing and developing a technical team.
Hands-on leader comfortable with technical writing and software engineering.
Strong technical writing skills for complex software products.
Experience with production website operations and best practices.
Familiarity with documentation-as-code workflows and modern software development.
Proficient in Astro, TypeScript/JavaScript, GitHub Actions, and CI pipelines.
Experience with content quality systems and contributor workflows at scale.
Ability to work with AI in documentation while maintaining accuracy.
Responsibilities
Lead and prioritize the Docs Engineering team while being hands-on in documentation and engineering.
Own the reliability and performance of the ClickHouse documentation website.
Research and write technical documentation independently, understanding product functionality through various methods.
Define and execute documentation strategy in collaboration with multiple teams.
Improve documentation workflows for efficient contributions from various stakeholders.
Review documentation pull requests and enhance high-impact content.
Build and maintain the documentation site's infrastructure and quality checks.
Establish workflows and standards for AI-generated documentation.
Benefits
Flexible work environment with remote options across 25 countries.
Employer contributions towards healthcare.
Equity in the company through stock options for new hires.
Flexible time off policies, with generous entitlements in various countries.
USD$500 for home office setup for remote employees.
Opportunities for in-person connection at company-wide offsites.
Full Job Description
We9re looking for a Documentation Engineering Manager to lead this work. This is a hands-on player-coach role for someone who can lead a small, highly technical team while contributing directly to both technical documentation and the engineering of the documentation website and its supporting infrastructure.
What you9ll do
Lead the execution, development, and prioritization of the Docs Engineering team while remaining hands-on in both technical writing and engineering.
Own the reliability, availability, performance, and technical evolution of the ClickHouse documentation website, treating it as a critical part of the product experience.
Research, develop, and write technical documentation directly, including independently understanding product functionality through source code, experimentation, testing, and collaboration with Engineering and Product, rather than relying on others to provide initial drafts.
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 that engineers, product managers, the Docs team, and external contributors can create and maintain excellent documentation efficiently.
Review documentation pull requests, triage issues, unblock contributors, and directly author or substantially improve high-impact content.
Build and maintain the documentation site9s 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 directly 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 the pace of product development.
Make documentation a driver of product adoption and growth, helping users discover ClickHouse, get started quickly, and convert into active users through an intuitive, frictionless documentation experience.
What we9re looking for
Prior experience managing and developing a technical team.
A hands-on leader who is comfortable 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, including the 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 a thoughtful point of view on 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.
Perks
Flexible work environment - ClickHouse is a globally distributed company and remote-friendly. We currently operate in over 25 countries.
Healthcare - Employer contributions towards your healthcare.
Equity in the company - Every new team member who joins our company receives stock options.
Time off - Flexible time off in the US, generous entitlement in other countries.
A USD$500 Home office setup if you9re a remote employee.
Global Gatherings - We believe in the power of in-person connection and offer opportunities to engage with colleagues at company-wide offsites.
