Adobe Robohelp

Get new posts delivered straight to your inbox.

Subscriber count: 3,220

Adobe Robohelp

Starting a new series on visual communication

Mar 12, 2016 • visual-communication

The other week on Twitter I noted that, despite the power visuals play in communicating technical concepts, there's not a lot of good information out there on visual communication in the context of technical documentation. As a result, I'm starting a series focused on visual communication, somewhat like the series I wrote about API documentation. One benefit of publishing this info on a blog is that I can regularly publish small articles and benefit from widespread feedback to help me course-correct early and move towards more accurate information.

Last week I posted the following on Twitter:

I’ve decided to start a course on visual communication, similar to the course I wrote about API documentation. With this approach, I write a couple of posts a week on the topic and try to arrange the posts into a course-like sequence. The idea is that rather than producing one-off blog posts, I leverage the power of the blogging medium to create a substantial body of information about a topic.

What exactly is the power of the blogging medium? Besides allowing niche topics to proliferate and the masses like me to publish and distribute information (and become visible in the process), the power of the blogging medium is that it chunks up writing so that you can push out information in small bits at regular intervals.

I don’t have to start a two-year research project during which I’ll be buried in a library, with my head down in dusty books, taking notes on paper, keeping track of sources and quotes and then organizing it all into a print-based book that is perhaps laboriously published after lengthy editorial and publishing reviews, edits, and production processes. That would be fun, I admit, but that kind of sequestered immersive library research doesn’t fit my life style.

Instead, with a blog, you can publish 2 page articles in an evening, get immediate feedback from practitioners around the world, and then make updates to your content or course-correct early. With a blog, you’re publishing online, in a space everyone can access and benefit from, and you can incorporate the feedback you get to inform your next posts. That’s the real benefit of blogging.

Why focus on visual communication, especially given my recent focus on more code-based content like API documentation? I’ve always been a strong believer that visuals are a major component of good docs, regardless of whether your audience is end-users or developers. Almost all doc is conceptual in some way and could benefit from visual communication techniques.

Additionally, the more complex a concept is, the more warranted it is to supplement your textual explanations with visuals. In fact, if you’re trying to document something complex, and you decide to go about it in a purely textual way, you’re making things much harder on yourself. Adding simple visuals goes a long way in clarifying complexity and making your job easier.

Where technical writers often go astray is in thinking that visuals (beyond simple screenshots) are the realm of graphic artists and UX designers only.

I also think that visual communciation topics will resonate more with a broader audience, since almost every techncial writer deals with visuals in some way or another (but only a small fraction work in API documentation).

So stay tuned for more information about this topic.


Get new posts delivered straight to your inbox.

Subscriber count: 3,220

About Tom Johnson

Tom Johnson

I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice, information architecture and findability, developer documentation, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here.