ABOUT THE TEAM:
The Developer Experience (DevX) team supports customers integrating and using Talon.One. The team is responsible for the product docs, developer docs, in-product UX copy, and the technical infrastructure behind the docs platform. Our primary audience spans two groups: marketing users operating the product (campaign managers, loyalty managers), and backend engineers integrating our APIs.
We use the docs-as-code approach. The content lives in GitHub and the documentation website runs on Docusaurus. The API reference is generated from OpenAPI specifications.
We are looking for a Documentation Engineer to help us extend our documentation platform and write new documentation for our customers. You will sit within the DevX team and work with Product teams. You write code and build tooling, and you also write documentation: reference content, integration guides, and developer-facing copy that no automation can produce to the right standard.
ONCE YOU ARE HERE YOU WILL:
- Write reference documentation, integration guides, tutorials, and product documentation
- Work in tandem with our current documentation engineer to find new ideas and solutions to current challenges
- Co-own the pipeline from OpenAPI spec to published API reference: validation, transformation, and deployment
- Build and maintain the scripts and CI jobs
- Reduce manual work for the technical writing team through tooling and process improvements
- Make deliberate decisions about how documentation is structured for AI agent consumption, not only human readers
- Contribute to OpenAPI spec quality by working with writers and engineers on field naming, example coverage, and schema structure
WHAT WE NEED YOU TO BRING TO THE TABLE:
- Developer empathy. You approach and write docs to increase an integrating engineer’s efficiency. You can produce clear, accurate content, not just tooling around it
- You can write code without AI as a crutch. You write scripts, debug error output, and ship working solutions independently
- Comfort with JavaScript/TypeScript. Our tooling uses it throughout
- Fluency with CI/CD pipelines
- Experience working with or reading OpenAPI 3.x specifications
- Clear understanding of what makes documentation machine-readable, not only human-readable
- Practical experience with AI tools, especially Claude. You use them daily and know how to prompt for useful output
- A preference for correctness over volume. You know when to automate and when automation produces noise
OUR TECHNOLOGY:
- Docusaurus for the docs site
- GitHub and GitHub Actions for content workflows and CI
- Scalar for API reference rendering
- OpenAPI 3.x as the single source of truth for API docs
- JavaScript/TypeScript for tooling and site customization
- Claude for AI-assisted workflows
- 90+ team of engineers, product managers and product designers in Berlin
- Leaders with 8+ years of experience building our promotions engine
- €1,000 annual learning budget and free German language courses to boost your skills
- 30 days of annual leave, plus extra paid days for your birthday and moving day
- Home office setup budget, a monthly home office allowance
- Freedom to work from abroad for up to 90 days worldwide!
- Mental health support with nilo.health and a discounted Urban Sports Club membership
- 20% company subsidy on your pension contributions
- Subsidised BVG public transport ticket and a dog-friendly Berlin office where your furry friend is welcome
- Lease your ideal bike through BusinessBike
WHY YOU SHOULD WORK FOR US:
- The right attitude: modern methods and a diverse, creative workspace with an open and international culture
- Everyone for the product: Together we create a flexible, highly scalable product with state-of-the-art technologies. We can only succeed if everyone works as a team
- Healthy Growth: Growing our company means growing everyone in the team. We love to share knowledge and learn
- A great environment: Flexible and family-friendly environment, bright and easily accessible offices, modern software and hardware
- High flexibility degree: Prefer to work early or late at night? Do you have to pick up your children from kindergarten? Do you prefer working abroad? We believe in results and motivated employees
Do you want this job?
We’d love to hear from you! Apply directly via the form below.
Talon.One is an Equal Employment Opportunity employer that proudly pursues and hires a diverse workforce. We do not make employment decisions on the basis of race, color, religious belief, ethnic origin, nationality, sex, gender identity, sexual orientation, disability, age, military or veteran status, or any other basis protected by applicable local, state, or federal laws or prohibited by company policy. As an employer we strive for a healthy and safe workplace and strictly prohibit harassment of any kind.
Find out more about our Candidate Privacy Policy.
Skills Required
- Comfort with JavaScript/TypeScript
- Fluency with CI/CD pipelines and GitHub Actions
- Experience working with or reading OpenAPI 3.x specifications
- Ability to write code, build tooling, and debug scripts independently
- Developer empathy and ability to write clear developer-focused documentation
- Practical experience with AI tools, especially Claude
- Understanding of machine-readable documentation and structuring docs for AI consumption
- Experience with docs-as-code workflows and Docusaurus
What We Do
Talon.One is building the world’s most sophisticated, API-based Promotion Engine. That means we provide the entire backend and user interface our clients need to build loyalty programs, generate coupons, track referrals, create bundles, and really any other promotion solution they can imagine — all using our rule-based engine. We believe that rewarding customers and creating incentives are an essential part of building meaningful relationships and we want to make rich, scalable promotion tools available to marketers in companies of all sizes. From our HQ in Berlin, to our offices in Boston, Birmingham and Singapore, Talon.One is made up of over 96 people from over 40 nationalities. Despite our different origins and our spread across the globe, we all have a few things in common — we love creative problem solving, we value independent thought and we want to give developers and marketers the tools they need to create promotions from scratch in a simpler, more intuitive way.
Why Work With Us
Talon.One is the first all-in-one Promotion Engine, and our technology is now the gold standard for promotion micro services. We’re strong advocates of flexibility in our product and the same is true in our working lives. We don’t believe that your job has to be the most important thing in your life. Everyone has unique reasons to feel inspired by
Gallery
