How to Get That Very First Technical Writing Job…

That very first technical writing job is the hardest for most writers and non-writers who are new to the field. Once that threshold is crossed, there’s usually no going back. The rest is usually a series of promotions or lateral and vertical moves from one company or assignment to another. For the freelancing “lone writers,”…

Read More

Two Different Meanings of Documentation Plan

(Copyright-free photo courtesy of Štefan Štefančík at Unsplash dot com) © Ugur Akinci There are TWO different varieties of “Documentation Plan”s. The first definition of “Documentation Plan” is a rather narrow one according to which the TCC template was designed: a plan to write a hi-tech user manual, a system administration or installation guide. This…

Read More

Shortcomings of Line Graphs (or Line Charts)

Line graph or line chart is one of the most frequently used types of graphic displays in technical communication. Here is an example: Consumption of Fiber by U.S. Apparel Industry, 1994-2001 (Millions of pounds) (Source: U.S. Department of Commerce, Bureau of Industry and Security) The most important aspect of a line graph is its use of “categories”…

Read More

Violating Document Specs May Cost CA County $548 Million

© Ugur Akinci I forgot the number of times I’ve emphasized the importance of clarity and accuracy in technical documentation in this blog and the dire consequences that can arise from such errors. To my online course students that’s something I make clear right away: a technical document must be correct and accurate above anything…

Read More

How to Decide How Granular Your Technical Writing Should Be

How granular and detailed your technical writing should be? This common problem is sometimes also referred to as the “granularity” issue. For example, consider the following alternative description of the same procedure: DESCRIPTION 1 (not so granular): Open First.html in IE9. DESCRIPTION 2 (very granular): In your browser’s URL window, enter the following URL and…

Read More

2 Technical Writing Topics: Future Prospects and a Marvelous Book

© Ugur Akinci As I was trolling through the Internet I was surprised to come across these income figures for technical writers. This confirms my general observation that, recession or not, tech writers continue to make excellent income with two conditions: 1) They should be working in the hi-tech industry. And 2) They should have…

Read More

What is “Inverted Pyramid” Style of Writing?

“Inverted Pyramid” Style of Writing is writing what is most important first and what is the least important the last. The traditional style of writing takes its time by first establishing the “base” of knowledge, similar to the way a regular pyramid would have its base at the bottom of the structure. All the other…

Read More

The Most Basic and Indispensable Parts of a User Manual

How do you explain the most important parts of a technical document, say a “User Manual,” to a complete beginner? I actually had that challenge when a student who has registered to one of my online courses admitted that he did not know where to quite begin writing his manual and what to include in…

Read More

How to Use Right Chevron (>) Correctly in Procedural Writing

RIGHT CHEVRON (>) is used in technical documents to denote a SERIES of SEQUENTIAL ACTIONS. If you’re writing a software or hardware manual, the changes are those actions would be “GUI actions,” that is, describing what the user should do on the screen with a mouse, keyboard shortcut, or a tablet pen. If you first…

Read More