From Enterprise Systems to Adobe Awards: How I Learned to Turn Confusion into Clarity

The Confession of a Career Zigzagger

Let me start with a truth that would make any career counselor weep: I have absolutely no idea how I ended up where I am.

Early in my career, I thought I’d pursue academic research in Sociology, graduate, then either teach or do research for a think tank, the corporate sector, or the government.

Fast forward to today: Adobe nominates me for awards while I manage documentation ecosystems serving hundreds of developers worldwide.

The unexpected part? Apparently, after watching developers struggle with bad docs for years, you eventually start building better ones yourself. (Want to know more about my journey at Adobe and current work? I’ve documented some of the bigger projects there.)

Chapter 1: Early Career Lessons (Or: How I Learned Documentation is Universal)

My tech writing journey began with complex enterprise systems. Working with engineers from different countries, speaking different languages, all trying to make expensive equipment work reliably taught me something fundamental.

Good documentation transcends language barriers. When your words might be the difference between success and failure, you get really good at clarity. Fast.

This skill transfers to everything else in tech.

Chapter 2: The Plot Thickens (2006-2018: Visual Designer Meets Full-Stack Reality)

At TOPAZ Technologies, I thought I’d be writing documentation and doing visual design work as the marketing department’s first designer.

Instead, I ended up:

• Designing all product user interfaces and experiences
• Leading AngularJS application overhauls—someone had to
• Training entire dev teams on how to use Angular Material—turns out good design systems don’t explain themselves
• Becoming a “Creative Director” (still not sure I earned that title)

The revelation: The gap between technical capability and user needs isn’t just a gap—it’s a canyon, and I got passionate about building bridges.

Chapter 3: Adobe and the Art of Scale (2018-Present)

Adobe happened, bringing a whole new level of complexity. Suddenly, I’m doing a lot more than writing docs. I’m creating documentation ecosystems for hundreds of developers, which includes:

• Creating a consolidated documentation site for both developers and merchants
• Building interactive React applications to demonstrate APIs and give developers a sandbox to play in
• Using AI to auto-generate API and how-to docs directly from the source code, making developers’ lives much easier

The scale is bonkers, but the mission remains the same: turn confusion into confidence.

My Core Philosophy

The best developer documentation doesn’t just inform. It transforms.

Those magical moments when a developer goes from “What the hell?” to “Oh, now I get it!” aren’t accidents. They’re carefully crafted experiences built on empathy, clarity, and—let’s be honest—lots of trial and error.

My method: I build the tools I write about. I code the interfaces I document. I use the CLIs I explain. In other words, write what you know and learn what you don’t.

Why? You can’t truly explain something you don’t understand from the inside. When I talk about reducing friction, it means I feel that friction myself and then try to build something that smooths it out.

This blog is where I spill those secrets and reflect on what I’ve learned about:

• Interactive documentation systems developers actually enjoy using (my deep dive on why documentation is so hard covers this extensively)
• CLI development that turns tedious tasks into one-liners
• Search implementations with Algolia that find what you need before you finish typing
• Information architecture using frameworks like Diátaxis (cooler than it sounds)
• Visual communication through animations that explain better than words
• Community building without corporate buzzword fluff

What’s Next

• War stories from presenting at Meet Magento Indonesia (featuring jet lag and cultural discoveries)
• Behind-the-scenes chaos from collaborating with cross-functional teams at Adobe
• Real insights from deep involvement in the Magento open-source community
• Honest takes on what works (and what spectacularly doesn’t)

The Invitation

This isn’t just a blog; it’s a conversation starter. The best developer experiences are built through shared learning, collective wisdom, and the occasional friendly argument about documentation structure.

Got a developer experience horror story, a documentation win that saved your sanity, or a question that’s been bugging you?

Let’s talk about it. After all, we’re all trying to make complex things make sense—and that’s more fun when we do it together. (And if you’re curious about the full story behind my career journey, check out my complete background and experience.)

---

P.S. - Wondering how someone accidentally becomes a developer experience specialist? Stick around. The stories get weirder.