// 01 about

Mira Balani

Technical Documentation Specialist, Staff Technical Writer at Miro

I make complex technical products easier to use, which contributes directly to customer experience, adoption, and retention.

Across developer, end-user, and enterprise documentation, my work starts before a word gets written: reading the source, collaborating with engineers, and settling the structure. From there, I build the standards, review workflows, and publishing pipeline that keep documentation accurate and on time.

See selected work Get in touch
mira.yaml source of truth
name: Mira Balani
role: Staff Technical Writer
company: Miro# 2021 to present
experience: 10+ years
writes:
- API reference
- Developer portals
- User guides and Help Center content
- Knowledge bases
builds:
- Documentation standards
- Review workflows
- Publishing pipelines
tooling: [OpenAPI, Docusaurus, Vale, GitHub Actions, DITA]
ai: [Claude, Claude Code, RAG, Agentic AI]
DevPortal Awards 2023 Best New DX Innovation and Best Onboarding, Miro Developer Portal
Society for Technical Communication Best of Show for API documentation, Tavisca
Society for Technical Communication Award of Merit for learning content, Salesforce
// 02 work

Experience

Miro
Staff Technical Writer, 2022 to present
Technical Writer, 2021 to 2022

Built the Developer Documentation Portal from the ground up with the team, and the documentation publishing pipeline on GitHub Actions, where AI-generated first drafts cut authoring time by at least 50%. Own enterprise documentation end to end, from information architecture through publication.

2021 to present
Salesforce
Staff Technical Writer

Wrote Trailhead learning content, API documentation, release notes, and administrator guides, and reviewed UI flows and UI text. The learning content won an Award of Merit from the Society for Technical Communication.

2019 to 2020
Tavisca Solutions
Documentation Head

Built the developer documentation portal and the documentation practice from the ground up. The portal won Best of Show for API documentation from the Society for Technical Communication.

2015 to 2018
// 03 portals and pipelines

Selected work

Miro

Developer Documentation Portal

Built from the ground up with the team for working developers. OpenAPI Specifications are the source of truth, reference documentation is generated from the spec, and real-time API calls let developers test endpoints while they read.

DevPortal Awards 2023
Best New DX Innovation and Best Onboarding. Runner-up for Best Community Outreach and Support and for Best Overall Developer Portal, Enterprise.

OpenAPI Generated reference Live API calls
developers.miro.com
Miro

Documentation publishing pipeline

Built with the team on GitHub Actions so documentation ships with the release rather than trailing it. AI produces first drafts from Jira ticket details and the resources provided, which cut authoring time by at least 50%. Automation carries the content through release, and Vale lints it, with versioned documentation throughout.

GitHub Actions Vale Versioned docs Docs-as-code AI first drafts
Tavisca Solutions

Developer documentation portal

Built from the ground up as Documentation Head.

Society for Technical Communication
Best of Show for API documentation.

API documentation Developer portal
Salesforce

Trailhead learning content

Written alongside API documentation, release notes, and administrator guides.

Society for Technical Communication
Award of Merit.

Trailhead Release notes Administrator guides
// 04 samples

Writing samples

Developer portal
Miro Developer Platform

API reference generated from OpenAPI Specifications, developer guides, and real-time API calls so developers can test endpoints while they read.

developers.miro.com
Learning content
Health Cloud Data Models for Healthcare

A Trailhead module for business analysts covering seven healthcare data models, from household and clinical data to insurance claims and care programs. The product has since been renamed Agentforce Health.

trailhead.salesforce.com
Enterprise docs
Enterprise Guard

Administrator documentation for Miro's enterprise security and compliance add-on: a deployment guide, data discovery and classification, content lifecycle, eDiscovery, and AI trust controls.

help.miro.com
// 05 practice

How I work

Building a documentation practice

I have done this twice, at Tavisca and at Miro: deciding the structure, the templates, the owners, the review cadence, and the versioning from nothing, and documenting the process so that it survives a handover.

Information architecture and standards

I decide the categories, standardize the formats, and organize content so it can be found, reused, and scaled across teams, in XML and DITA where reuse matters. I set and enforce the standards, templates, terminology, and review workflows around it.

Docs-as-code and release velocity

Markdown and MDX in Git, GitHub workflows, versioned documentation, and linting in the pipeline, so documentation ships with the release rather than trailing it.

Explaining AI and agent-based concepts

I use Claude and Claude Code daily, build multi-step LLM pipelines with structured outputs and evals, and work with agentic AI and RAG systems. I structure content so retrieval works for AI assistants as well as people, and write about it for non-expert audiences.

Technical and customer-facing documentation

Product documentation, API reference, Help Center and knowledge base content, release notes, SOPs, onboarding guides, and training material. I work in instructional design myself, so collaborating with designers and trainers is familiar from both sides.

Education and certifications

Bachelor of Arts, English, Indira Gandhi National Open University (IGNOU), India.

Design Thinking (Stanford University Graduate School of Business), Information Mapping (TechDoc), Certified Usability Analyst (Human Factors International), PRINCE2 Agile Foundation & Practitioner (AXELOS), Certified ScrumMaster and Certified Scrum Product Owner (Scrum Alliance), Data Visualisation & Storytelling (Growth Tribe), Professional Diploma in Digital Marketing (Digital Marketing Institute), and Salesforce Trailhead Ranger.

In progress: Claude Certified Architect (Foundations), AI Governance Professional (IAPP AIGP)

// 06 toolkit

Toolkit

Authoring and publishing
Docs-as-code, Docusaurus, MkDocs, ReadMe, Git, Confluence, Oxygen, Zendesk
API documentation
OpenAPI Specifications (OAS), Redocly, Swagger UI, Stoplight, Postman
Languages and formats
Markdown, XML, DITA, HTML, CSS, JavaScript, Node.js, JSON, Python, Java
Pipelines, quality, and tooling
GitHub Actions, Jenkins, Netlify, Vale, documentation analytics, Visual Studio Code, Cursor, Jira, Coda, GitHub, diagramming and graphic editing tools
AI
Claude and Claude Code, agentic AI and RAG systems, AI-assisted authoring and review, and automation of documentation publishing pipelines
// 07 talks

Talks, features, and community

Feature
State of Docs Report 2025: AI and the Future of Documentation
Panel
Podcast
// 08 contact

Let's talk

Always happy to talk about documentation, developer experience, and finding the right balance of humans and AI.

EU citizen with full right to work in the EU

[mail] mirabalani@gmail.com [in] LinkedIn