Tech Writers as Outsiders—a Good Thing?

Twitter Updates


San Francisco PechaKucha Night
San Francisco IxDA


In The Technical Writer as an Outsider: How Ambitious Are You?, Tom Johnson talks about the appropriate place in software development to get the technical writers involved, and makes some interesting observations on what the mere existence of external help means about a product.

He makes an interesting argument that the best place is at the end of the development cycle. He is right in that this affords the writer the chance to see the product with a perspective similar to that of the actual user, not having been biased by the close association with the development process that blinds every creative person (including writers!) to the non-obvious elements of what they have created.

As a tech writer, I have experienced that bias repeatedly over the years, and it is a hard perspective to overcome. The perspective of the outsider is essential to creating good usability, but only getting that perspective at the end of the development cycle means that the feedback loop is longer than the Enron audit trail or completely non-existent.

What is needed instead is a means of inserting that outside perspective continually throughout the design process. Some amount of it must come from within each designer, but you must also design a mechanism for getting a true outsider’s perspective at each milestone or iteration—ideally from someone who hasn’t seen the previous milestones/iterations. But having an additional perspective at each of these steps from the same experienced tech writer will help you ensure the consistency necessary to create a polished product.

Author: Peter Sheerin

Peter Sheerin is best known for the decade he spent as the Technical Editor of CADENCE magazine, where he was the acknowledged expert in Computer-Aided Design hardware and software. He has a long-standing passion for improving usability of software, hardware, and everyday objects that is always interwoven in his articles. Peter is available for freelance technical writing and product reviews, and is exploring career opportunities in interaction design. His pet personal project is exploring the best ways to harmonize visual, tactile, and audible symbols for improving the effectiveness of alerting systems.

Leave a Reply