Documentation Engineer (JavaScript/TypeScript)

TL;DR

Documentation Engineer (JavaScript/TypeScript): Developing and maintaining the documentation platform and API reference for a promotions engine with an accent on docs-as-code and OpenAPI pipelines. Focus on building CI/CD tooling for documentation, improving machine-readability for AI agents, and creating high-quality technical guides.

Location: Berlin, Germany (Hybrid)

Company

hirify.global provides a flexible, highly scalable promotions engine for businesses.

What you will do

• Write reference documentation, integration guides, and tutorials for both marketing users and backend engineers.
• Co-own the pipeline from OpenAPI spec to published API reference, including validation and deployment.
• Build and maintain scripts and CI jobs to automate documentation workflows.
• Develop tooling to reduce manual effort for the technical writing team.
• Structure documentation specifically for AI agent consumption and machine-readability.
• Collaborate with engineers to improve OpenAPI spec quality, field naming, and schema structure.

Requirements

• Proficiency in JavaScript and TypeScript for tooling and site customization.
• Fluency with CI/CD pipelines and GitHub Actions.
• Practical experience working with OpenAPI 3.x specifications.
• Ability to produce clear, accurate technical content independently without relying on AI.
• Hands-on experience with AI tools, especially Claude, for workflow optimization.
• Must be based in Berlin to work from the office.

Culture & Benefits

• 30 days of annual leave plus extra paid days for birthday and moving.
• €1,000 annual learning budget and free German language courses.
• Home office setup budget and monthly home office allowance.
• Freedom to work from abroad for up to 90 days worldwide.
• 20% company subsidy on pension contributions and subsidised BVG public transport ticket.
• Dog-friendly office environment in Berlin.