---
title: Richard Rabil
description: Principal Technical Writer & AI Knowledge Architect.
---

# Richard Rabil

**Principal Technical Writer—AI Knowledge Architect**

Delivering technical knowledge at scale—for humans *and* agents.

Hi, I'm Richard. I bring 20+ years of experience creating product and engineering documentation for SaaS and enterprise software.

- [About Me](/about)
- [View My Work](/docs/portfolio/samples)

## What I do

**Dual Identity**

Technical Communication—With a master's degree in technical communication, I'm an expert in researching and organizing complex technical information, designing attractive documents, and creating content that people actually read.

AI Knowledge Architecture—I build AI knowledge assets and governance frameworks that enable teams (and agents!) to deliver quality knowledge to their audiences as the docs grow. This site is proof: a [docs-as-code pipeline](/how-i-built-this) that lints prose, validates links, and deploys vetted content via CI/CD.

[More About Me](/about)

## Selected Work

A sampling of things I've shipped, including:

- "Why Aesthetics Matter in Technical Docs, with Richard Rabil"—Document360 Podcast, August 2025
- "Order Out of Chaos: Patterns of Organization for Writing on the Job"—A List Apart, July 2018
- "Content Strategy in Action: Enabling Sales with Product Documentation"—STC Intercom, May 2019
- "Opower Digital Self-Service - Energy Management"—Overview Guide, Oracle Utilities Docs
- "Opower Analytics Visualization"—User Guide, Oracle Utilities Docs
- "Data Transfer Specifications"—Specification, Oracle Utilities Docs

[View More Samples](/docs/portfolio/samples)

## What Is This Site?

Not a metaphor. This portfolio is built and deployed through a real, gated pipeline: Lint, Link Check, Build, Content Checks, Deploy. Every push runs all five before anything ships. If a check fails, the site doesn't deploy. Every page also publishes a Markdown twin and an `llms.txt` entry, so an agent can read the source instead of scraping the page.

[Learn more about how this site was built](/how-i-built-this)

## Want to Get in Touch?

Contact me on LinkedIn.

[Connect on LinkedIn](https://www.linkedin.com/in/rrabil/)