Knowledge Architect & Technical Writer (Docs-as-Code)

Adyen; Chicago (IL); Hybrid; USD 100,000 - 125,000; Full time

Job summary

Adyen in Chicago is seeking a systems-minded Technical Writer to join our Docs Excellence team. This role blends system-building and editorial curation to transform complex APIs and developer content into precise, reliable documentation.

You will design metadata schemas, review auto-generated content, and collaborate with Product, Engineering, Support, and Implementation teams in a docs-as-code environment using Git and Markdown.

Qualifications

• 3+ years documenting complex technical spaces, including APIs, SDKs, or developer platforms.
• Ability to 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 to gather context and streamline documentation work.
• Someone who asks why before executing; strong problem-solving and stakeholder-management skills.
• Comfortable managing multiple stakeholders in a fast-moving environment.

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 for both human developers and AI systems navigating integrations.

Skills

Technical writing

Git

Markdown

Docs-as-code

AI tools

Critical thinking

Tools

Postman

VS Code

Job description

Adyen in Chicago is seeking a systems-minded Technical Writer to join our Docs Excellence team. This role blends system-building and editorial curation to transform complex APIs and developer content into precise, reliable documentation.

You will design metadata schemas, review auto-generated content, and collaborate with Product, Engineering, Support, and Implementation teams in a docs-as-code environment using Git and Markdown.