Manager, Documentation Engineering
$165k - $230k • United States • Full-time
Posted 10d ago
Job Location
United States
Also open in Europe
Tech Stack
Remote Work Policy
On-site
Employment Type
Full-time
Categories
AI Engineer
About the job
ClickHouse is seeking a Manager, Documentation Engineering to lead a highly technical team responsible for the company's documentation and its supporting infrastructure. This is a hands-on player-coach role where you will contribute directly to technical writing and the engineering of the documentation website. The team ensures documentation is accurate, discoverable, and trustworthy, while also owning the documentation infrastructure as a critical, production-facing service. You will lead the team's execution, development, and prioritization, while also owning the reliability, availability, and performance of the documentation website.
Responsibilities
- Lead the execution, development, and prioritization of the Docs Engineering team, remaining hands-on in technical writing and engineering.
- Own the reliability, availability, performance, and technical evolution of the ClickHouse documentation website.
- Independently research, develop, and write technical documentation by understanding product functionality through source code, experimentation, and collaboration.
- Define and execute documentation strategy in partnership with various departments and the open-source community.
- Improve docs-as-code contribution workflows for efficient documentation creation and maintenance.
- Review documentation pull requests, triage issues, unblock contributors, and author or 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 AI-generated documentation.
- Work with teams across ClickHouse to understand needs, translate them into documentation processes, coach authors, and resolve priorities.
- Ensure documentation remains accurate, comprehensive, discoverable, and aligned with product development.
- Drive product adoption and growth through an intuitive and frictionless documentation experience.
Requirements
- Prior experience managing and developing a technical team.
- 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.
- Ability to investigate functionality, read source code, validate product behavior, and translate findings into clear documentation.
- Experience building, maintaining, and operating production websites, with a strong understanding of reliability, availability, performance, and monitoring.
- 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.
- Excellent cross-functional communication skills and ability to influence technical and product partners.
- Comfort operating in a fast-paced, high-expectation environment.
Benefits
- Flexible work environment - globally distributed and remote-friendly.
- Employer contributions towards healthcare.
- Equity in the company.
- Flexible time off (US) / generous entitlement (other countries).
- USD$500 Home office setup for remote employees.
- Global Gatherings – opportunities to engage with colleagues at company-wide offsites.
