Technical Writer

Braze•San Francisco, CA

3d•$73,000 - $109,000•Hybrid

About The Position

At Braze, we are seeking a technical writer to join our Tech Writing team. This role involves thinking in systems and sentences, with documentation treated as infrastructure – a structured body of knowledge for developers and machines. You will shape how knowledge is organized and generated, as well as write it. The documentation practice is established with a mature style guide, writers owning product domains, and AI-assisted drafting. Your role is to advance this practice architecturally by defining metadata, taxonomy, and context for AI tooling, and editorially by becoming an expert on the Braze platform to ensure documentation is trustworthy, accurate, well-structured, and consistent in voice.

Requirements

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

Responsibilities

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

Benefits

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®