Archive | Tech Comm RSS feed for this section
work

My Internship as a Technical Writer: what I learnt

Guest Post By Dave Fruscalzo Over this just-passed Australian summer, I completed a five-week internship as a technical writer for a growing software company. The internship was arranged through my university, where I am now completing my final semester, enrolled in a Postgraduate Diploma in Arts (Editing and Communications). I was persuaded to try technical [...]

Read more
snip

RoboHelp Snippets: Benefits and Limitations

Have you ever used RoboHelp (or other) snippets? I have experience with RoboHelp, so I’ll stick to that, though I know that other help authoring tools have similar features. I think snippets are great, but (in RoboHelp, at least) they do have their limitations. What’s a snippet? A snippet is a bit of text with [...]

Read more
Mine!

Preserving the Writer’s Ownership

Preserving the writer’s ownership As an editor of technical documentation, I often aim for consistency in language and tone, ruthlessly cutting out any sign of the writer’s personality. I want each help topic, for example, to feel as though it was created by the same person. Whatever tone we choose for the help is the [...]

Read more
find_it

Just Find and Replace! Just No.

  Have you ever discussed a change to a document and been given the advice to “just do a find and replace”? As with most jobs, people who don’t write think that writing is easier than it really is. “Just do a find and replace” is one of the most common, and short-sighted, comments I [...]

Read more

Saying Too Much isn’t Saying Enough

Putting too much information in a sentence gets across less information. Sentence with A and B gets across A and B. Sentence with A, B, C, D, and F gets across NOTHING. Why, because no one will be able to read it. (Or they won’t want to bother trying.)

Read more
Write It Long; Shorten It

Write It Long; Shorten It

A quick tip that I sometimes forget. Complicated ideas are often really hard to write concisely. When I try to compress an idea, I find that I start to lose accuracy, or add ambiguity. The thing that works best for me is to write it exactly how I’d explain it to someone, without worrying about [...]

Read more
bad_ui

When Should You Change UI Copy?

Have you ever worked on a product that has poor UI copy or design? Of course. What about poor UI copy or design that’s been around a long time and is now the standard way of doing things for that product? When do we force the issue and change it? For professional reasons, I can’t [...]

Read more
woman

Don’t Say What Should Happen. Say What Will Happen.

Have you ever said that something “should” happen, in order to avoid being wrong if it doesn’t? I’ve seen lots of documentation explaining how to do a task, then ending by saying something like: When you click End World, the Doomsday Clock should start. My beef today is with the word “should.” I understand the [...]

Read more
rewrite

The Tech Writer vs. the English Major

As a writer, I know that there are times to break grammatical rules in order to communicate better. Sometimes, for example, that means choosing “who” over “whom,” so as not to remind my readers of their high school principal. But for me, when the rules seem to be at odds with my ear, I usually [...]

Read more
Two Hidden Features in Microsoft Word

Two Hidden Features in Microsoft Word

A quick tip today about nonbreaking spaces and optional hyphens in Microsoft Word. Let’s jump in. Nonbreaking spaces A nonbreaking space tells Word not to put a line break between a given two words. For example, the following example looks a little funny, because the person’s name is split over a line break: I want [...]

Read more