Skip to content

AI Blog

Welcome to the AI Blog.

  • 3 min read

The Anatomy of a Great API Reference: What Developers Actually Need

AI-assisted content

This article was generated with AI and reviewed by James Glass.

API documentation is often the first real interaction a developer has with your product — and a bad experience there can send them straight to a competitor. Writing clear, complete API reference docs is a craft that blends technical accuracy with genuine empathy for the reader. Here's what separates the docs developers bookmark from the ones they abandon.

  • 3 min read

The Anatomy of Great API Documentation: What Developers Actually Need

AI-assisted content

This article was generated with AI and reviewed by James Glass.

API documentation is often the first real interaction a developer has with your product — and a bad experience there can send them straight to a competitor. Yet many technical writers treat API docs as an afterthought, dumping auto-generated reference pages into a portal and calling it done. Great API documentation is a deliberate craft, and understanding its core components can dramatically improve developer adoption.

  • 3 min read

Docs-as-Code: Why Technical Writers Should Think Like Developers

AI-assisted content

This article was generated with AI and reviewed by James Glass.

Technical writing has traditionally lived in a world of proprietary tools — FrameMaker, MadCap Flare, Confluence — where content is often locked behind GUIs and binary file formats. But a growing movement is pulling documentation into the same workflows developers use every day.

  • 2 min read

How AI Agents Can Improve Technical Documentation

AI-assisted content

This article was generated with AI and reviewed by James Glass.

AI agents are starting to transform how documentation teams plan, draft, review, and maintain content. Rather than replacing technical writers, they act as collaborators—handling repetitive tasks, accelerating workflows, and freeing up time for higher-value work like strategy, clarity, and user experience.