What are the responsibilities and job description for the Technical Writer position at Photon?
What to expect
- Translate complex technical concepts into clear, clientready documentation for developers and partners
- Produce and maintain API docs, SDK guides, integration walkthroughs, and FAQs
- Ensure docs are accurate, consistent, and aligned with product behavior and supported use cases
- Apply a developer-first mindset: clarity, examples, edge cases, and common pitfalls
- Create content that supports self-service integration and reduces support dependency
How they ll work
- Partner closely with product, engineering, and developer experience teams
- Intake requirements from specs, APIs, and source code not just verbal guidance
- Iterate quickly based on technical reviews and feedback
- Follow established style guides, terminology, and information architecture
Deliverables
- Endtoend integration guides (getting started advanced flows)
- Reference documentation (API endpoints, parameters, errors)
- Code samples and diagrams (where appropriate)
- Update and version docs alongside product releases
What success looks like
- Faster developer onboarding and time to first transaction
- Fewer how do I integrate? support questions
- Documentation that is publishready, scalable, and reusable across teams and channels
Experience Requirements
- Proven experience as a technical writer for APIs, platforms, or developer products
- Strong understanding of REST APIs, JSON, authentication flows, and webhooks
- Experience documenting integration guides and reference documentation
- Comfortable working from technical specs, API definitions, and source code
- Prior exposure to payments, fintech, or B2B SaaS platforms a plus
- Familiarity with developer portals / docs-as-code workflows (e.g., Git, Markdown, OpenAPI)
- Able to collaborate effectively with engineering and product teams
- Track record of producing clear, high-quality, externally published documentation