# Technical Writer - Docs Excellence

**Company**: Adyen
**Location**: Chicago
**Work arrangement**: hybrid
**Experience**: senior
**Job type**: full-time
**Salary**: $100,000 - $125,000
**Category**: Product Management
**Industry**: Technology

**Apply**: https://job-boards.greenhouse.io/adyen/jobs/8095966?utm_source=yubhub.co&utm_medium=jobs_feed&utm_campaign=apply
**Canonical**: https://yubhub.co/jobs/job_240ae358-a7d

## Description

We are seeking a systems-minded Technical Writer to join our Docs Excellence team in Chicago. This role involves designing and maintaining metadata schemas, reviewing and editing auto-generated content, and authoring API reference guides. You will partner with cross-functional teams to capture platform logic and validate merchant integration flows.

Responsibilities:

- Design and maintain metadata schemas (YAML front matter), ontology, and rules that support automated, first-pass content generation workflows.

- Review, edit, and fact-check auto-generated content and code snippets for technical accuracy, edge cases, and voice.

- Author and refine API reference guides, integration workflows, and conceptual docs in a docs-as-code environment (Git, Markdown).

- Partner with Product Managers, Engineers, Support, and Implementation Managers to capture platform logic and validate merchant integration flows.

- Structure documentation so it works for two audiences at once: human developers navigating integrations, and AI systems parsing context.

Requirements:

- 3+ years documenting complex technical spaces, including APIs, SDKs, or developer platforms, with a portfolio that shows real writing and editing craft.

- Comfortable thinking beyond the page: you can design ontologies, metadata schemas, and structured information models.

- A high-judgment editor who can spot hallucinations, inaccuracies, or structural gaps in automated drafts.

- Fully fluent in Git, Markdown, and docs-as-code toolchains.

- A practical, hands-on user of AI tools and LLMs to gather context and streamline documentation work.

- Someone who asks why before executing.

Bonus Points:

- Experience with Postman, VS Code, or similar tools.

- Basic ability to read code snippets (Java, Python, TypeScript) to verify API logic.

The annual base salary range for this role is $100,000 - $125,000 plus RSUs.

## Skills

### Required
- YAML
- Git
- Markdown
- docs-as-code
- API documentation
- technical writing

### Nice to have
- Postman
- VS Code
- Java
- Python
- TypeScript

---

Source: [Apply at job-boards.greenhouse.io](https://job-boards.greenhouse.io/adyen/jobs/8095966?utm_source=yubhub.co&utm_medium=jobs_feed&utm_campaign=apply)