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
* 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.
Ideal Qualifications
* 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.
More About the Opportunity
* Remote and asynchronous — control your own work schedule
* Expected commitment: min 30 hours/week
* Project duration: ~6 weeks
Compensation & Contract Terms
* $50–80/hour
* Independent contractor arrangement
* Paid weekly via Stripe Connect
Application Process
* Submit your resume followed by domain expertise interview and short form
About Mercor
* 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.