Overview
Lead the Docs Engineering team at ClickHouse as a hands-on player-coach, owning both technical documentation and the engineering of the documentation website and its supporting infrastructure.
What you'll 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 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 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 you'll need
- 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.
Details
- Location: United States.
- ClickHouse is a globally distributed company and remote-friendly; it currently operates in over 25 countries.
Read the full description and apply on the company’s own careers page.