spaceship

Grammar! That vs. Which

The words “which” and “that” have a long and tangled history together. I’d guess that most native English-speakers don’t recognize a difference between the words in most sentences. For example: The spaceship that looked like a tulip crashed into my swimming pool. The spaceship which looked like a tulip crashed into my swimming pool. Most [...]

Read more
newspaper

Some Online Resources for Tech Comm

Here are links to blogs and other resources for Tech Comm on the Net….

Read more
fake

Faking a Short Document

People don’t read long docs, but you need have the info in there, right? Here are a few tips for making a long doc look short….

Read more
A Better Place for Related Topics

A Better Place for Related Topics

…usability tests, my group found that people just don’t click the Related Topics button. Which made us sad, because we’d put good content in there. Maybe I should say we had HIDDEN good content in there….

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
Mother Theresa

I’m Good and I’m Doing Good

  I recently read an online argument about one of the most commonly used, and commonly fought, expressions around: It’s the answer to “how are you?” “I’m doing good” vs. “I’m doing well.” [NOTE: I'd also like to defend "I'm good," but others have done it well, so I've pasted a link below.] But first, [...]

Read more
siri

Ambiguous Pronoun

Not a real post here, but just something I thought was funny. I’m reading about “Siri,” Apple’s new electronic assistant. You ask it to do things, and it does them. But I think the marketing writers should have reworked the paragraph shown in the image below:

Read more
feedback

How to Give Proper Feedback to a Writer

Have you, as a writer, ever received feedback on a doc that didn’t give you what you need? As an editor or stakeholder, have you ever had to give feedback on a doc, but it didn’t work out as well as you’d hoped? I think sometimes the problem is that the person giving edits doesn’t [...]

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
Editing Equals Deleting Words

Editing Equals Deleting Words

A question I usually ask myself when first editing a document is, “how can I reduce this by a third?” Usually, people add more words because they think that those words help make the point accurately and completely. And it’s my job to find a way to say the same thing with fewer words. But [...]

Read more
shakes

My English is as Good as Yours

Due to some very silly conversations I’ve had recently, I looked up this post that I had written for another blog a few years ago. Since it relates tangentially to writing, I thought I’d post it here. If you’ve already read it, well, read it again! Chaucer with an American accent Some people seem to [...]

Read more

Hidden Meanings in Language

Language is funny. This post doesn’t give any helpful tips about using language, or about writing. But I recently thought of one of many examples of how native speakers use language in a way that might seem inscrutable to new speakers. Think of the difference between asking: Are you cold? And Aren’t you cold? Strangely, [...]

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