"Will Artificial Intelligence Kill College Writing?" asks a professor in The Chronicle of Higher Education. Micah Mattix gives what I think is a thoughtful response: "This is one of the problems with teaching writing exclusively as a tool. Most tools are replaceable. But I don’t think writing—real writing—is in any danger of being replaced by … Continue reading Whether AI Will Replace Writing
Tag: technical communication
Job Security
From chapter 48 of Snowcrash by Neal Stephenson: "Fisheye has taken what appears to be an instruction manual from the heavy black suitcase. It is a miniature three-ring binder with pages of laser-printed text. The binder is just a cheap unmarked one bought from a stationery store. In these respects, it is perfectly familiar to … Continue reading Job Security
Do Attractive Documents Work Better?
Design expert Donald Norman has written that when people are anxious, they narrow their thought processes. Conversely when people are happy, they become more creative and imaginative at solving problems. If this is true, it means that one of the best things a technical writer can do is create beautiful content that moves readers to a happier, more adaptive emotional state. Or so I contend.
Best Practices for Content Reuse
For technical writers, content reuse it a great idea---but way more difficult in practice than it sounds. Here are some of my practical suggestions on how to do it in a sustainable way, based on my years of experience implementing it with tools like Confluence and Madcap Flare.
Resources on How Technical Writers Can Support Sales
I just published an article on how documentation can enable sales. Here's an annotated list of the resources I used in my research.
What It’s Like to Work in Technical Writing [Email Interview]
A student from my alma mater reached out to me with questions about the wonderful world of technical communication. Here's a transcript (peppered, of course, with delightful Dilbert comics).
How to Write Effective Online Help: Results from an Informal Benchmarking Exercise
My writing colleagues and I recently presented on our favorite help systems from companies like Lego, Spotify, Google, and WordPress. Here are some things we found, and some implications for writers of help content.
Do Technical Writers Dream of Arbortext Editor?
Arbortext Editor is a software program that lets you do "structured writing"---a special kind of writing in which every piece of content you compose follows one or more predefined rules. In theory this helps writers to develop consistent, high-quality content. The problem is that the tool has a lot of serious shortcomings. Here's my wishlist of things to improve.
My Article from STC Intercom: Designing Wiki Templates for Today’s Web
Last November I published an article in Intercom, a magazine produced by the Society for Technical Communication. It was paywalled at the time, but the exclusive rights period has since expired so I have copied it here. Synopsis: A regular part of the technical writer's job is to design document templates that help others jumpstart the writing process. How do our template design strategies change as more documentation moves from the print medium to web browsers and mobile devices?
Are Technical and Creative Writing Antithetical? Yes and No.
They are very different. But how different, exactly?