Mercor is collaborating with a top-tier developer documentation team to support high-priority technical writing and content validation tasks. The goal is to enhance the clarity, completeness, and usability of technical content critical to developers' day-to-day integration work.
Requirements
- 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.
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.
Other
- 5+ years of experience in technical writing or developer documentation roles.
- 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
