Software Technical Writers
Role Overview
Mercor is collaborating with a top-tier developer documentation team to support high-priority technical writing and content validation tasks. This opportunity is ideal for seasoned API documentation professionals with deep experience in OpenAPI/Swagger, release note generation, and static site deployment workflows. The goal is to enhance the clarity, completeness, and usability of technical content critical to developers' day-to-day integration work. This is a short-term, high-impact contract with flexible hours.
Key Responsibilities
Mercor is collaborating with a top-tier developer documentation team to support high-priority technical writing and content validation tasks. This opportunity is ideal for seasoned API documentation professionals with deep experience in OpenAPI/Swagger, release note generation, and static site deployment workflows. The goal is to enhance the clarity, completeness, and usability of technical content critical to developers' day-to-day integration work. This is a short-term, high-impact contract with flexible hours.
Key Responsibilities
- Import and validate OpenAPI specifications; ensure syntax and schema completeness.
- Write human-readable descriptions for endpoints, parameters, requests, and responses.
- Create realistic usage examples and annotate rate limits, pagination, and authentication behavior.
- Generate and deploy HTML reference documentation using static site generators (e.g., Docusaurus, MkDocs).
- Review and categorize release changes from Git logs and issue trackers into user-friendly notes.
- Test and verify code samples, markdown syntax, and internal/external links in documentation pull requests.
- Troubleshoot and resolve documentation build failures via CI/CD pipelines and local environment testing.
- Update knowledge base articles for accuracy post-product changes, including screenshots and version info.
- 5+ years of experience in technical writing or developer documentation roles.
- Strong proficiency with OpenAPI/Swagger, Markdown, and static site generators.
- Familiarity with Git, CI/CD workflows, and link-checking tools.
- Experience documenting SDKs, APIs, CLI tools, or developer-facing UIs.
- Attention to detail in writing, syntax, and formatting.
- Ability to write concise, developer-focused documentation with minimal supervision.
- Remote and asynchronous — control your own work schedule
- Expected commitment: min 30 hours/week
- Project duration: :6 weeks
- $50–80/hour
- Independent contractor arrangement
- Paid weekly via Stripe Connect
- Submit your resume followed by domain expertise interview and short form
- Mercor is a talent marketplace that connects top experts with leading AI labs and research organizations.
- Our investors include Benchmark, General Catalyst, Adam D’Angelo, Larry Summers, and Jack Dorsey.
- Thousands of professionals across domains like law, creatives, engineering, and research have joined Mercor to work on frontier projects shaping the next era of AI.