I also recorded this post as a conversational podcast (rather than a narrated one).
Listen to this post:
You can download the MP3 file, subscribe in iTunes, or listen with Stitcher.
Parallels with content strategy
The transition from API documentation to developer portals mirrors the same transition that took place in tech comm domain from documentation to content strategy. When that transition happened, I resisted calling myself a content strategist because I felt like much of the tech writer’s role already involves making many decisions about content strategy. But it’s not always the case, and probably much less often than I assumed. The meaning of “content strategy” forked into several different connotations whether you’re in marketing, tech comm, or running an SEO business, which further complicated the direction.
Regardless of parallels, in many circles related to API docs, I keep seeing an emphasis on “developer portals.” Sometimes anything that isn’t strictly “API refer
