Senior Technical Writer

PubMatic; United States; Hybrid; USD 125,000 - 140,000; Full time

Benefits offered by this job

Hybrid schedule

Annual bonus

Healthcare coverage

Job summary

PubMatic seeks a Senior Technical Writer to produce developer-focused API documentation and SDK guides that translate complex specifications into actionable guides. You will craft API references, integration tutorials, and code examples in multiple languages, aligning with engineering and product teams.

You will leverage OpenAPI and REST/GraphQL concepts, collaborate via GitHub, and shape documentation standards while applying AI-based drafting to accelerate initial content with rigorous

Qualifications

• 10+ years of technical writing experience with a portfolio demonstrating API reference docs and code examples.
• Proven experience with OpenAPI Specification and REST APIs.
• Proficiency with GitHub and markdown-based documentation workflows.
• Strong working knowledge of at least 2-3 programming languages.
• Solid grasp of API design principles, including REST and GraphQL.

Responsibilities

• Create comprehensive API documentation from OpenAPI files, including endpoints, parameters, auth, errors, and code samples.
• Develop SDK documentation covering installation, configuration, and implementation.
• Write integration guides, tutorials, and code examples in JavaScript, Python, and Go.
• Document webhooks and authentication mechanisms for API consumption.
• Manage code-to-doc workflows by parsing API specs with Swagger/OpenAPI.
• Leverage AI tools to accelerate drafts, then refine for accuracy and brand voice.
• Collaborate with engineering and use GitHub to manage docs alongside releases.
• Implement and test samples; contribute to standards, style guides, and reducing technical debt.

Skills

API documentation

OpenAPI

REST APIs

GraphQL

GitHub

Markdown

Programming languages

Code samples

AI-assisted docs

Documentation standards

Tools

Swagger

MkDocs

ReadMe

GitHub

Markdown

Job description

Role overview

This Senior Technical Writer role creates clear, accurate, developer-friendly technical documentation that turns complex API specifications and code into comprehensive guides. The writer specializes in API reference documentation, SDK documentation, integration guides, tutorials, and code-to-doc workflows using industry standards like the OpenAPI Specification, and bridges engineering, product, and documentation teams for a scaled digital advertising platform.

Responsibilities

• Create comprehensive API documentation from OpenAPI Specification files, including endpoint descriptions, parameters, authentication, error handling, and code examples.
• Develop SDK documentation covering library installation, configuration, and implementation.
• Write integration guides, tutorials, and how-to guides for common developer use cases, plus code examples in multiple languages such as JavaScript, Python, and Go.
• Document webhooks, authentication mechanisms, and best practices for API consumption.
• Manage code-to-doc workflows by parsing and organizing API specifications with tools such as Swagger and OpenAPI.
• Leverage generative AI tools to accelerate initial drafts from code, OpenAPI specs, and code samples, then evaluate and refine AI output for accuracy, completeness, clarity, and brand voice.
• Collaborate with engineering to extract technical information, clarify undocumented behavior, and ensure accuracy, while working with GitHub to manage documentation changes alongside code releases.
• Implement and test code samples for accuracy, maintain documentation consistency across endpoints, SDKs, and guides, and contribute to documentation standards, style guides, and audits for technical debt.

Requirements

• 10+ years of technical writing experience with a portfolio demonstrating strong API reference documentation and code examples.
• Proven experience with OpenAPI Specification and REST APIs.
• Proficiency with GitHub and markdown-based documentation workflows.
• Strong working knowledge of at least 2-3 programming languages.
• Solid grasp of API design principles, including REST and GraphQL concepts, and the ability to communicate them clearly to developers.

Nice to have

• Experience documenting SDKs or client libraries, and familiarity with code-to-doc automation tools and AI-assisted documentation generators.
• Portfolio examples showing use of generative AI to accelerate documentation creation, including evaluating and improving AI-generated technical content.
• Contributions to open-source documentation projects, experience with documentation analytics and user feedback integration, and familiarity with developer experience workflows.
• Hands-on experience with ReadMe, MkDocs, or similar documentation platforms, plus prompt engineering techniques for API documentation and code examples.

Benefits and work setup

• Hybrid schedule of 3 days in office and 2 days remote, designed to maximize collaboration and productivity.
• Total compensation range of $125,000-$140,000 USD, plus bonus and a competitive benefits package.
• Paid leave programs, paid holidays, healthcare, dental, and vision insurance, disability and life insurance, commuter benefits, physical and financial wellness programs, unlimited discretionary time off, mobile reimbursement, stocked pantries, and in-office catered lunches five days per week.