Braze

Technical Writer

Braze • $72K — $97K *
Technical Services
Less than 5 years of experience
Job Overview by Ladders

Qualifications

  • 3+ years experience writing technical documentation for APIs, SDKs, or developer platforms.
  • Strong understanding of information architecture and knowledge management principles.
  • Proficient in Git, Markdown, YAML, and docs-as-code practices.
  • Experience using AI and LLMs effectively in technical writing.
  • Able to communicate complex concepts to both technical and non-technical audiences.

Responsibilities

  • Define and maintain metadata and taxonomy for AI-assisted documentation workflows.
  • Review machine-generated content for technical accuracy and consistency.
  • Create and update API references and integration guides in a docs-as-code environment.
  • Become an expert on Braze's platform to distill complex information into user-friendly language.
  • Collaborate with multiple teams to validate technical integrations and platform behavior.
  • Organize documentation to serve both developer needs and system retrieval requirements.
  • Continuously improve documentation and client experience based on feedback and research.

Benefits

  • Competitive compensation potentially including equity.
  • Retirement and Employee Stock Purchase Plans.
  • Flexible paid time off policy.
  • Comprehensive medical, dental, vision, life, and disability insurance benefits.
  • Family services including fertility benefits and paid parental leave.
  • Professional development opportunities with career pathing and yearly learning stipends.
  • Curated in-office experience to enhance community and team connections.
  • Annual company-wide Volunteer Week and donation matching initiatives.
Full Job Description
We're looking for a technical writer to join our Tech Writing team - someone who thinks in systems as naturally as they think in sentences. At Braze, documentation is infrastructure: a connected, structured body of knowledge that both developers and machines read from, not a collection of individual pages. You'll spend as much time shaping how that knowledge is organized and generated as you will writing it. Our documentation practice is already well established, with a mature style guide, writers who own specific product domains, and a workflow where AI-assisted drafting sits alongside traditional technical writing. Your job is to push it forward on two fronts. The first is architectural: defining the metadata, taxonomy, and context our tooling relies on to produce useful first drafts. The second is editorial: becoming a genuine expert on Braze's platform and bringing the kind of scrutiny that turns a plausible draft into documentation our customers can actually trust - accurate, well-structured, and consistent in voice with every other Braze experience. WHAT YOU'LL DO • Define and maintain the metadata (YAML front matter), taxonomy, and contextual guidelines that our AI-assisted drafting workflows depend on • Review and verify machine-generated prose and code samples line by line, checking technical accuracy, edge-case behavior, and voice before anything ships • Write and revise API references, integration guides, and conceptual documentation in our docs-as-code environment, owning feature updates end to end • Become an expert on the Braze platform, distilling complex functionality into approachable, user-centric language • Help oversee and maintain the documentation GitHub repository • Work closely with Product Management, Engineering, Support, Customer Success, Marketing, and Implementation teams to pin down how the platform actually behaves and to validate real customer integration paths • Organize content so it serves a developer mid-integration and a system retrieving context - the same structure has to work for both • Ensure documentation applies voice, style, and branding consistent with other client experiences • Keep improving our documentation and client education experience through feedback-gathering, research, experimentation, and data-driven decisions • Promote and foster knowledge exchange across teams WHO YOU ARE • 3+ years writing documentation for genuinely technical audiences - APIs, SDKs, or developer platforms - with writing samples that show both range and precision • Fluent in information architecture and knowledge management • A rigorous editor with a sharp instinct for the draft that reads well but says something subtly wrong • Comfortable with Git, Markdown, YAML, and docs-as-code workflows • An active, practical user of LLMs and AI tooling in your own work - you've figured out where they help and where they don't • Able to explain technical concepts to engineers and to non-technical readers, and to know which one you're writing for • Curious by default: you want to understand why something works the way it does before you document it, and you'll say so when a plan doesn't hold up • Steady across many stakeholders and comfortable when priorities shift • Excellent interpersonal skills, a user-centric team-player attitude, and confidence presenting your work and your reasoning • A relentless advocate for the user experience For candidates based in Canada, the pay range at the start of employment for this position is expected to be between CA$72,000 - CA$97,000/year, with an expected On Target Earnings (OTE) between CA$80,000 - CA$108,000/year (including performance-based or variable compensation (bonus or commission). Your particular offer may vary depending on multiple individual factors, including market location, job-related knowledge, skills, and experience. In addition to cash compensation, this role qualifies for a comprehensive Total Rewards package that includes equity grants of restricted stock (RSUs) so that you will own a piece of our company. WHAT WE OFFER Braze benefits vary by location, and we encourage you to review our specific benefits offerings for each country at here. More details on benefits plans will be provided if you receive an offer of employment. From offering comprehensive benefits to fostering hybrid ways of working, we've got you covered so you can prioritize work-life harmony. Braze offers benefits such as: • Competitive compensation that may include equity • Retirement and Employee Stock Purchase Plans • Flexible paid time off • Comprehensive benefit plans covering medical, dental, vision, life, and disability • Family services that include fertility benefits and equal paid parental leave • Professional development supported by formal career pathing, learning platforms, and a yearly learning stipend • A curated in-office employee experience, designed to foster community, team connections, and innovation • Opportunities to give back to your community, including an annual company-wide Volunteer Week and donation matching • Employee Resource Groups that provide supportive communities within Braze • Collaborative, transparent, and fun culture recognized as a Great Place to Work®

About Braze

Braze is a customer engagement platform that delivers messaging experiences across push, email, in-app, and more. The company's platform is designed to help brands create personalized and relevant messaging experiences for their customers. Braze was founded in 2011 and is headquartered in New York, New York.
Learn more about Braze
Size
1,000 employees
Market Cap
$2.4 billion
Industry
Founded
2011
NASDAQ

Similar Jobs

More Jobs at Braze

More Technical Services Jobs

Find similar Technical Writer jobs: