Role OverviewMercor 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.