Posts from the ‘Technical Writing’ category

Reviving the Hall of Technical Documentation Weirdness

1029 Internet years ago, in 2003, I started something called the Hall of Technical Documentation Weirdness. It compiled “wacky, bizarre, surreal and otherwise strange examples of…

Read article

It’s Really a Simple Process…

From the men’s room at Workspace: I like their frank procedural writing. And, toilet soakers, shouldn’t this have been thoroughly covered by grade two?

Read article

Tearing Down and Reinforcing Gender Stereotypes, All in One Sentence

I was just re-reading a whitepaper I’m writing, and encountered this sentence: If the lead developer on an open source project takes maternity leave, there aren’t…

Read article

There Are No Frickin’ Cross References in Apple’s Pages?

We’re spending the weekend putting the final touches on our ebook, and planning our marketing push. I’m doing the final layout work on the book, and…

Read article

Keep Marketing Away From the Manuals

Most days, I straddle the Berlin Wall between product development and marketing. I used to work amongst the programmers as a technical writer. At Capulet, we…

Read article

Seeking a Junior Contract Technical Writer

We’ve got a project starting in late December with which we need some help. We’re looking for a junior writer to do about 40-45 hours of…

Read article

The Gomery Report is Surprisingly Readable

I didn’t believe Derek when he made this point, but then I hadn’t actually looked at the official report (it’s got it’s own URL, too). For…

Read article

Should I Become a Technical Writer?

Over at Ask Metafilter, somebody asked that question. As a former technical writer myself, I was interested to read the discussion. Here’s the worst advice I…

Read article