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.