Cville AI Explorers (CvAIEx) - Virtual Lunch & Learn #1

### Your README Has a Voice: Turning Repos Into Narrated Onboarding Tools

### by Owen Zanzal

### **A practice run through of Owen Zanzal's DevOps Days DC talk. https://devopsdays.org/events/2025-washington-dc/welcome/**

DevOps engineers live at the intersection of automation, velocity, and onboarding chaos. We build pipelines that deploy code in seconds but the people shipping that code still spend hours digging through outdated wikis, tribal knowledge, and repo sprawl.

In this talk, I’ll share a bold experiment: what happens when you turn your repo into a podcast?

RepoRad.io is an open-source, CLI-first tool that reads your GitHub repo, generates onboarding scripts using GPT-4, and produces audio episodes with OpenAI voice synthesis narrated walkthroughs of your codebase, changelog, CI/CD, and Terraform.

This isn’t a product pitch. It’s a DevOps story about scaling documentation, sharing architectural context, and reducing onboarding load without writing a single paragraph.

We’ll cover:

The real cost of “hidden knowledge” in DevOps-heavy orgs

How repo narration works (architecture + prompts + audio)

What happens when you give your code a voice and your team listens

Tradeoffs of LLM-based narration (accuracy, privacy, tone)

How we use GitHub Actions to keep episodes fresh and changelogs on repeat

You’ll leave with:

A new way to scale DevOps documentation without documentation debt

A template to onboard new engineers in 10 minutes or less

CLI commands and configs you can run on Monday

Yes, your README can talk. And no, it doesn’t have to be boring.