Manager, Documentation Engineering

ClickHouse
United States
Remote

Who this role is best for

Best suited to hands-on technical leaders with experience in documentation-as-code and open-source collaboration, working in fast-paced, high-expectation environments.

Best fit for

  • Individuals with strong cross-functional collaboration skills and a background in complex software documentation
    — “Work directly with teams across ClickHouse to understand their needs, translate them into practical documentation processes”
  • Professionals comfortable with building and maintaining production websites and CI/CD pipelines
    — “Experience building, maintaining, and operating production websites, with a strong understanding of reliability, availability, performance”

Things to consider

  • This role demands a balance between leadership and hands-on technical execution
    — “hands-on player-coach role for someone who can lead a small, highly technical team while contributing directly”
  • Candidates must be adept at managing AI-generated documentation while ensuring accuracy and trust
    — “Experience designing or operating content quality systems, automation, and contributor workflows at scale”
  • The role involves direct collaboration with engineering and product teams to align documentation with product development
    — “Ensure documentation remains accurate, comprehensive, discoverable, and aligned with the pace of product development”

How to stand out

  • Emphasize experience in managing documentation-as-code workflows and CI/CD pipelines in your resume
    — “Comfort working with Astro, TypeScript/JavaScript, GitHub Actions, pull-request workflows, and CI pipelines”
  • Showcase examples of improving documentation quality and contributor experience in your interview prep
    — “Improve docs-as-code contribution workflows so that engineers, product managers, the Docs team, and external contributors can create and maintain excellent documentation efficiently”
  • Highlight your ability to independently research and write technical documentation for complex systems
    — “Research, develop, and write technical documentation directly, including independently understanding product functionality through source code”
  • Demonstrate a track record of defining and executing documentation strategies across cross-functional teams
    — “Define and execute documentation strategy in partnership with Engineering, Product, Product Marketing, Learning, Support, Growth”
Pace · SteadyCollaboration · HighAutonomy · MediumDecision Impact · Team

Derived from job-description analysis by Serendipath's career intelligence engine.

What success looks like

  • improved documentation quality and efficiency
  • enhanced user experience through documentation
Typical background
technical writing experiencesoftware engineering background

Skills & requirements

Required

Technical WritingSoftware EngineeringTeam LeadershipDocumentation InfrastructureProcess DesignAI Integration In Documentation

Preferred

Hands-on Experience In Technical DocumentationOpen-source Community Engagement

Stack & domain

Technical WritingSoftware EngineeringProcess DesignDocumentation InfrastructureAI AgentsLeadershipCommunicationProblem-solvingTeamworkProject ManagementData PlatformOpen-sourceDocumentation

About the role

Original posting from ClickHouse via Ashby

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 https://clickhouse.com/company/careers. Check out our blog posts https://clickhouse.com/blog or follow us on LinkedIn https://www.linkedin.com/company/clickhouseinc/life/0c1ee7f4-2129-488d-b413-e7f6270659fd/?viewAsMember=true 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 https://clickhouse.com/legal/applicant-privacy-notice for our Privacy Statement.

Source: ClickHouse careers (Ashby)

Similar roles

More roles at ClickHouse