WebAPIs & Developer Documentation Writer (OAuth/JavaScript)

US Tech Solutions, Inc.
Mountain View, United States of America
2 days ago

Role details

Contract type
Permanent contract
Employment type
Full-time (> 32 hours)
Working hours
Regular working hours
Languages
English
Experience level
Intermediate

Job location

Mountain View, United States of America

Tech stack

JavaScript
API
Programming Tools
OAuth
Open Source Technology
Markdown
Web Applications
Code Comments
Information Technology
Web Technologies
Web Api

Job description

  • We are seeking an experienced Web APIs & Developer Tools Documentation Specialist to join our client's News Customer Solutions division. In this role, you'll help external news publisher developers understand and effectively use web APIs and developer tools.
  • This strategic documentation role requires a strong grasp of technical concepts, the ability to translate them for developer audiences, and a passion for making complex systems simple and accessible.
  • You'll create impactful documentation that helps media organizations worldwide use modern developer tools to deliver content to their audiences. If you're passionate about APIs, simplifying complex systems, and writing for a global developer audience, this role is for you., * Own Technical Documentation Across Three Core Areas:
  • Developer Website - External-facing API guides, usage explanations, and best practices.
  • Open-Source Demo Application - Interactive examples demonstrating API usage in JavaScript.
  • Internal Documentation - Resources for product, engineering, and cross-functional teams.
  • Document OAuth Workflows and Web API Integration: Produce clear, accurate documentation for OAuth 2.0 flows (e.g., client credentials, authorization code), token lifecycle, and secure integration patterns tailored for developer audiences.
  • Develop JavaScript-Based Code Samples and Guides: Create concise, real-world examples of API consumption, OAuth implementation, error handling, and interactive user flows using JavaScript.
  • Write and Structure Content Using Markdown: Use Markdown to develop well-structured, developer-friendly documentation for web-based and code-oriented environments.
  • Collaborate Across Functions to Translate Complex Concepts: Work with product managers, engineers, and designers to convert technical specifications, design flows, and product requirements into clear, user-centric documentation.
  • Audit and Optimize Content Ecosystem: Review developer portals, internal wikis, help centers, and open-source repositories to identify redundancies, gaps, and inconsistencies.
  • Enhance Information Architecture: Identify and implement improvements in content organization and narrative flow to improve discoverability, reuse, and clarity.
  • Contribute to Open-Source Documentation: Write inline code comments, onboarding instructions, and reference materials that improve clarity and usability for open-source contributors.

Requirements

  • 5+ years of experience creating technical documentation for software products, platforms, and developer audiences, including developer portals, Computer Science course material, and open-source projects.
  • 2+ years of experience collaborating closely with software engineers, with a strong technical background or hands-on development experience.
  • Proven expertise in documenting web APIs, ideally for public-facing developer portals or open-source projects.
  • Solid understanding of modern web-based API usage, including client- and server-side OAuth and API client libraries.
  • Familiarity with JavaScript and common API use cases (able to read and interpret code).
  • Comfortable writing in Markdown within code-oriented environments.
  • Strong grasp of developer experience and technical storytelling.
  • Eagerness to learn and document emerging web technologies.

Experience (Preferred):

  • Experience with or knowledge of OAuth and authorization standards.
  • Background in information architecture, content structuring, or reorganizing large content libraries.
  • Publicly available writing samples or contributions to open-source documentation.

Education:

  • Bachelor's degree or equivalent practical experience.

Apply for this position