Sr. Technical Writer

Alianza,-Inc.; United States; On-site; USD 110,000 - 160,000; Full time

Job summary

Alianza is seeking an experienced API technical writer to partner with Product, Engineering, and Support Business Engineering teams in building developer documentation for the Alianza Developer Portal and API suites.

This role sits within the existing technical writing team and focuses on developer-facing content — documenting structure, workflows, and style guidelines to ensure seamless integrations with Alianza’s APIs.

Qualifications

• 7+ years creating technical docs, with at least 3 years focused on API or developer-facing content.
• Proven REST API documentation experience with references, auth flows, errors, and code samples.
• Familiarity with OpenAPI/Swagger and related tools.
• Excellent English writing and technical style.
• Ability to navigate ambiguity and coordinate with SMEs.
• Portfolio of developer-facing docs including API references and guides.
• Self-starter capable of managing multiple projects.

Responsibilities

• Plan, write, and maintain API reference docs, developer guides, tutorials, and release notes.
• Evaluate and refine generated docs from OpenAPI pipelines and provide structured feedback.
• Define API documentation processes and iterate workflows for consistency.
• Create and maintain an API documentation style guide.
• Collaborate with Engineering, Product, and other teams for accurate information.
• Review and edit existing docs for clarity and accuracy.
• Attend product demos to stay updated on API changes and deprecations.
• Gather feedback from developers and iterate content accordingly.
• Work with Oxygen XML and Paligo on tooling initiatives.
• Deliver high-quality results in a fast-paced environment with autonomy.

Skills

API documentation

REST API documentation

OpenAPI/Swagger

English writing

Cross-team collaboration

Documentation strategy

Project management

Tools

Oxygen XML Author

Paligo

Git

CI/CD pipelines

Job description

Alianza is looking for an experienced API technical writer to partner with our Product, Engineering, and Support Business Engineering teams in building developer documentation for the Alianza Developer Portal and related API suites.

This position sits within Alianza’s existing technical writing team within the Support Business Engineering department. The role is distinct from current technical writing positions in its focus: while the broader team owns user-facing content, this role owns developer-facing content — the documentation, structure, and workflows that determine whether an experience provider can successfully integrate with Alianza’s APIs.

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.

Required Qualifications

• 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.

Preferred Qualifications

• 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.