Note: The job is a remote job and is open to candidates in USA. Alianza provides telecommunications and cloud communications solutions, including APIs that enable experience providers to integrate with its platform. The Sr. Technical Writer will own developer-facing API documentation, including reference materials, guides, tutorials, release notes, and documentation workflows. The role partners with Product, Engineering, Support Business Engineering, and technical writing teams to ensure accurate, consistent, and high-quality developer experiences.
Responsibilities
- Plan, write, and maintain API reference documentation, developer guides, integration tutorials, and release notes
- Evaluate and refine generated documentation output from OpenAPI spec pipelines, providing structured feedback on API quality and documentation completeness
- Define API documentation processes and iterate existing workflows for consistency and efficiency across engineering and technical writing teams
- Create and maintain an API documentation style guide covering terminology, structure, code samples, and error documentation
- Collaborate with Engineering, Product, and other teams to gather technical information and ensure documentation accuracy
- Review and edit existing documentation to improve clarity, accuracy, and consistency
- Attend product demos and engineering meetings to stay current on API changes, new features, and deprecations
- Gather feedback from the developer and experience provider community and iterate content accordingly
- Work with other technical writers on content migrations and documentation tooling initiatives in Oxygen XML and Paligo
- Deliver quality results in a fast-paced environment with a high degree of autonomy
Skills
- 7+ years of experience authoring technical documentation, with at least 3 years focused on API or developer-facing documentation
- Demonstrated experience writing REST API documentation, including API reference, authentication flows, error handling, and code samples
- Familiarity with OpenAPI/Swagger standards and tools used for documenting APIs
- Excellent written and verbal communication skills with a strong command of English grammar and technical style
- Ability to navigate ambiguity, identify the right subject matter experts, and advocate for quality documentation across teams
- Portfolio of developer-facing documentation including API reference, integration guides, tutorials, and/or style guidelines
- Self-starter with the ability to manage multiple projects in a dynamic environment
- Experience with developer portal platforms such as Kong Konnect, Redocly, or similar
- Familiarity with Oxygen XML Author (DITA XML) and/or Paligo (cloud-based CCMS for DocBook XML)
- Experience with docs-as-code workflows, including Git and CI/CD pipelines
- Knowledge of HTML, CSS, and Markdown for documentation formatting and portal customization
- Experience in SaaS, telecom, or VoIP environments
- Experience working on a global product with partners across multiple time zones
- Familiarity with voice APIs, SIP, or real-time communications infrastructure
- Strong interest in AI-assisted documentation tools and emerging developer experience standards
Company Overview
Company H1B Sponsorship