[Blog](/blog)/[Technical documentation](/blog/category/technical-documentation)/[Writing style](/blog/category/technical-documentation/writing-style)

## Writing style

#### [Three Root Causes: Why we lose to the invisible man](/blog/three-root-causes-invisible-man)

After identifying unforced errors in API design, I found three root causes on the tennis court that map directly to how we build APIs. Here's what they are and how to fix them.

![avatar](/content-assets/adam-b1c762e267cef6b1.png)

By Adam AltmanFebruary 05, 2026

#### [Beat the Invisible Man: Unforced errors in API design](/blog/beat-the-invisible-man)

Most APIs don't fail because competitors outplayed them. They fail because of unforced errors—small mistakes that shouldn't exist. Here's how to identify and eliminate them.

![avatar](/content-assets/adam-b1c762e267cef6b1.png)

By Adam AltmanJanuary 29, 2026

#### [Tips for Documentation Migration](/blog/documentation-migration-tips)

Make your documentation migration a huge success with these practical tips on planning, collaboration, and quality checks.

![avatar](/content-assets/taylor-cartoon-headshot-b3dbf8ff17ecc517.png)

By Taylor KrusenJuly 17, 2024

#### [Making metrics at WriteTheDocs Portland 2024](/blog/wtd-2024)

Learn about the importance in using research and metrics in creating value for readers and demonstrating value as writers, as well as some highlights from the talks.

![avatar](/content-assets/heather-066f6db4d77100af.png)

By Heather ClowardApril 25, 2024