Manager, Documentation Engineering

ClickHouse; Madrid; Hybrid; EUR 100,000 - 140,000; Full time

Benefits offered by this job

Flexible work environment

Healthcare

Equity in the company

Time off

Home office setup (USD$500)

Global gatherings

Job summary

ClickHouse is seeking a Documentation Engineering Manager to lead a highly technical Docs team and contribute directly to both technical writing and the engineering of the docs website and its supporting infrastructure.

In this hands-on leadership role, you’ll shape the documentation strategy, improve docs-as-code workflows, review contributions, and collaborate across Engineering, Product, and open-source communities to deliver accurate, scalable documentation for developers.

Qualifications

• Experience leading a technical team and delivering docs-driven projects.
• Ability to investigate product functionality via source code and experiments.
• Strong written communication for developers and engineers.
• Experience building and operating production websites with reliability in mind.
• Familiarity with docs-as-code workflows and modern software practices.
• Comfort using AI to support documentation without sacrificing quality.

Responsibilities

• Lead the Docs Engineering team, staying hands-on in writing and engineering.
• Oversee reliability and evolution of the ClickHouse docs website.
• Research, write, and verify technical documentation directly from code.
• Define docs strategy with Engineering, Product, PMM, Learning, Support, and open-source.
• Improve docs-as-code workflows for engineers and contributors.
• Review PRs, triage issues, and author or improve content.
• Build and maintain documentation infrastructure, CI, and monitoring.
• Establish AI-safe workflows and quality standards for generated docs.
• Collaborate with teams to translate needs into practical docs processes.
• Ensure accuracy, discoverability, and alignment with product pace.
• Drive adoption and growth through a clear, frictionless docs experience.

Skills

People management

Technical writing

Software engineering

Process design

Cross-functional collaboration

AI in documentation

Tools

Astro

TypeScript/JavaScript

GitHub Actions

CI pipelines

Job description

ClickHouse is an open-source company building the fastest and most resource-efficient real-time data platform. Our documentation is a core part of how users learn, adopt, and succeed with ClickHouse.

Our Docs team is deeply technical, independently able to use our products, read source code, test behavior, and write accurate, high-quality documentation from scratch. The team also enables contributions from across the organization and open-source community, ensuring the documentation remains consistent, discoverable, and trustworthy.

Beyond the content, the Docs team owns the documentation infrastructure as a critical, production-facing service. Its availability, performance, and reliability directly affect our users' ability to work with ClickHouse. The team is responsible for building, operating, and continuously improving this experience.

We're 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 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 we’re 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 eligible team member who joins our company receives equity.
• Time off – Flexible time off in the US, generous entitlement in other countries.
• A USD$500 Home office setup if you’re 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.

Culture - We All Shape It

As part of a rapidly scaling start-up, you will be instrumental in shaping our culture.

Are you interested in finding out more about our culture? Learn more about our values here. Check out our blog posts or follow us on LinkedIn to find out more about what’s happening at ClickHouse.

Equal Opportunity & Privacy

ClickHouse provides equal employment opportunities to all employees and applicants and prohibits discrimination and harassment of any type based on factors such as race, color, religion, age, sex, national origin, disability status, genetics, protected veteran status, sexual orientation, gender identity or expression, or any other characteristic protected by federal, state or local laws.

Please see here for our Privacy Statement.