Strong technical writing skills with a focus on complex software documentation
Experience in building and maintaining production websites
Familiarity with documentation-as-code workflows
Proficient in Astro, TypeScript/JavaScript, and CI/CD practices
Ability to work with AI in documentation processes
Excellent cross-functional communication skills
Responsibilities
Lead and prioritize the Docs Engineering team while actively contributing to documentation and engineering tasks
Own the performance and evolution of the ClickHouse documentation website
Research and write technical documentation independently, collaborating with engineering teams
Define and execute documentation strategies in partnership with various departments
Enhance documentation workflows for efficient contributions from multiple stakeholders
Review and improve documentation pull requests and high-impact content
Build and maintain the documentation site's infrastructure and quality checks
Benefits
Flexible work environment with remote options
Employer contributions towards healthcare
Equity in the company through stock options
Flexible time off policies
USD$500 for home office setup for remote employees
Opportunities for global gatherings and in-person connections
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.
