---
title: "Survival strategies for API documentation – slides and recording"
date: 2015-02-03
description: "$( document ).ready(function() { // Handler for .ready() called. $('#toc').toc({ minimumHeaders: 3, listType: 'ul', showSpeed: 0, headers: '#content h2, #content h3, #content h4, #content h5, #content h6' }); /*..."
canonical_url: https://idratherbewriting.com/2015/02/03/upcoming-webinar-survival-strategies-for-api-documentation/index.html
---

> For AI agents: a documentation index is available at https://idratherbewriting.com/llms.txt. Markdown versions of all pages are available by appending .md to any page URL.

# Survival strategies for API documentation – slides and recording

I'm gave a webinar to the [Southern Ontario STC](http://www.stc-soc.org/calendar/2015-02-02.php/) on Monday, Feb 2. This post contains the slides and recording.

## Webinar description

> ### Survival strategies for API documentation
>
> If you're documenting an API for the first time, you may be in survival mode just trying to decipher the code, unravel developer speak, and publish a coherent set of documentation. API documentation is a new landscape for most technical writers.
>
> Traditional platform APIs are often published through a document generator such as Javadoc or Doxygen, while REST or web APIs are published using everything from document generators that parse Swagger and RAML specs to custom toolsets to manually-formatted web pages either from static site generators (such as Nanoc) or homegrown sites.
>
> The reference documentation is actually the easy part. The real difficulty, and most likely the one you'll be tasked with, is showing developers how to use the API, the way the various endpoints or classes work together, and how you can piece it all together with the right parameters to achieve an actual business goal.
>
> In this presentation, I'll give you an introduction to API documentation, try to answer your questions, and give you tips for getting started in the right direction.

For more details, see the [STC Ontario site](http://www.stc-soc.org/calendar/2015-02-02.php/).

## Video recording

[Video: YouTube video player](https://www.youtube.com/embed/I8rGe2w1sAo?si=8BXAHkEXgE4j3yzC)

## Slides

**[Survival Strategies for API Documentation: Presentation to Southwestern Ontario STC chapter](https://www.slideshare.net/TomJohnson7/survival-strategies-for-api-documentation-presentation-to-southwestern-ontario-stc-chapter)** from **[Tom Johnson](https://www.slideshare.net/TomJohnson7)**

**Listen here:**

[Audio](https://www.podtrac.com/pts/redirect.mp3?https://s3.us-west-1.wasabisys.com/idbwmedia.com/podcasts/stcontariowebinarapi.mp3)

[![](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/apple_podcasts.png)](https://itunes.apple.com/us/podcast/id-rather-be-writing-podcast/id277365275) [![](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/watchonyoutubeblack.png)](https://www.youtube.com/@idratherbewriting) [![](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/spotify.png)](https://open.spotify.com/show/4HeOZfPGMMfViOhVS40QBD)

The presentation is similar to the one I gave at TC Camp, which I recorded and made available [here](https://idratherbewriting.com/2015/01/27/api-workshop-video-audio-slides-workshop-files-from-tc-camp/). However, this presentation is more compressed, lasting just one hour instead of two.