Skip to main content

To the Unknown Technical Writer at Mr. Coffee

Dear Unknown Technical Writer at Mr. Coffee,

Let me begin by saying how pleased we are with your company's product, the Mr. Coffee Coffeemaker, VB Series (color: black). As a replacement for a previous Mr. Coffee 4-cup coffeemaker, our new VB Series coffeemaker is truly an improvement in our coffee-making life.

Thank you, Unknown Technical Writer at Mr. Coffee--I feel so odd not being able to address you as Sir or Madame, as I don't even know how you prefer to be addressed--for providing clear and concise instructions for how to clean our new coffeemaker; following your pointer to "refer to the parts diagram" while washing the various parts was a stroke of brilliance. I also enjoyed your enticement to "Enjoy it!" once I knew my coffeemaker was ready to use. As a former technical writer myself, I can only imagine how hard you had to fight to keep that exclamation point in the copy after many rounds of edits.

I would also, Unknown Technical Writer at Mr. Coffee, like to extend my sympathies for the heavy hand--and I can only assume this hand had a lawyer attached at the other end--insisting on inserting troubleshooting steps that can, if we can be honest one writer to another, only be described as stupid. If someone needed to look in your tightly crafted manual to search for the solution to a problem described as "THE COFFEEMAKER ONLY BREWS WATER", that person really shouldn't own a coffeemaker at all, much less one of such quality as a Mr. Coffee Coffeemaker, VB Series (color: black).

As so, Unknown Technical Writer at Mr. Coffee, I sympathize at your plight when, after reading this theoretically impossible problem (really? a machine that magically creates water) you were forced to insert into your Framemaker file the "Possible Cause" of "There are no coffee grounds in the filter basket". I would love to buy you a beverage of your choice, as well, for the capstone "Solution" ("ADD DESIRED AMOUNT OF COFFEE"), but I fear you may now be lost to us in a cultist compound of some kind or, worse, management.

But, should this message reach you, Unknown Technical Writer at Mr. Coffee, kudos to you and your work. In your honor, I will complete the steps in the "Adding Water and Coffee" section, and then proceed directly to "BREWING COFFEE NOW" so I may enjoy a delicious cup of coffee. Salut!


  1. Truly an homage paid from one to another within the craft, but none the less, an interesting read for layman.

  2. Brilliant. Especially the part about the exclamation point. I am sure that writer fought, tooth and nail, to keep said exclamation point.



Post a Comment

Popular posts from this blog

RIP Tom Petty

Tom Petty died today, aged 66. I won't claim to be a huge Tom Petty fan, but I've bought an album or two and sang along in the car to one of those songs everyone knows. I'll  stream a lot of his catalog today to remember the songs I've heard once or hundreds of times.

I also owe Petty credit for a singular moment in my life, and one I never expected to last in my mind.

Nearly 20 years ago, I was a fresh-ish faced transplant to Ann Arbor, MI by way of my first "real job" out of college, working for a software company in Dexter. I was renting a house with some other folks who'd also been displaced as a result of a fire at my first apartment. I was the only family member East of Lansing, which made me a contact point for anyone going through Detroit Metro airport.

Which is how my uncle Dean came to spend a few hours with me one evening. At the time, my grandparents (his parents) were wintering in Texas. My grandfather had health problems most of his life and…

Google Inbox: A classic Google product

My work domain (an EDU) recently had Google Inbox enabled so I had a good chance to try it out. My personal email is relatively quiet and, I believe, doesn't provide a good Inbox experience. Work is more active and requires actual management, something I've tossed many a tool at over the years. As part of my work life, I supported the Google Apps for EDU installation here and took a pretty extensive presentation to campus about how to manage large amounts of email.

Inbox is a classic Google product: the distillation of a number of excellent ideas into a set of half-complete features built for a use case most people don't meet. We've seen this in the past in products like ChromeVox, Google's Chrome extension for accessibility. ChromeVox works great on ChromeOS devices, but completely ignores the point that most users of accessibility tech (AT) don't have or want ChromeOS devices and come to services with their AT in tow. ChromeVox also ignores decades of convent…


Evernote, for better or worse, is the best note-taking service for my needs. It works across all my devices/computers/modes. It's fairly easy to get stuff into it. Hell, they even have 2-Factor authentication. The Windows app is a little clunky and my girlfriend and I have never been able to get shared notes to work properly (conflicted note! three times in the same grocery trip!), but what service is perfect? At least they have nice socks.

Everything, in fact, is pretty good as long as you don't screw up. And screw up I did. I'm not very regular about making backups, but I do make them every month or so. Once you figure out how to create a backup, that is.

There's a helpful Export Note option (which turns into Export Notes when you select multiple notes HINT). The export process is essentially opening All Notes, selecting every note, and then choosing Export Notes. Or something like that; Evernote never tells you, you're left to figure it out on your own. The file…