Visually Appealing Documents Combine Text with Images

A few years ago, I was scouring magazines to get ideas for quick reference guide layouts. In particular, I found that WIRED magazine has some of the most creative and engaging layouts, often with text laid out in three or four columns, or along the side of a graphic, or in various quadrants about the page. I was trying to figure out the right layouts that would give my quick reference guides the same eye-popping appeal when I realized som...

Why Rubrics Fail as a Means of Measuring Documentation Quality

Alice Jane Emanuel has an interesting post that details her methods for measuring the quality of documentation. The post consists of notes from a webinar she gave on the subject. Alice writes, ... I have never seen anything like what I envisage in my head, which closes the argument by creating a weight or optimal rating for each necessary element in the technical communication being reviewed. When you start to consider necessary elements ...

What I've Learned from Lunchtime Creative Writing Workshops

About a month ago, one of my colleagues approached me and asked if I would be interested in having an informal creative writing workshop every now and then. Huh, I thought, maybe. I floated the idea by the other four writers in our technical writing group, and it turns out everyone was interested in participating in this, except one, who was already busy with another creative writing workshop that had even more participants. We've met a c...

How I Took Back My E-mail Inbox

Feb 20, 2012 update: See my new email strategy. For the past couple of years, my gmail inbox has been flooded with so much email that unless I respond to incoming email within a day, it gets buried with other incoming email. I'm guessing that many others have a similar problem. Gmail has come out with various solutions -- priority inboxes, stars with various colors to note importance. But I finally bit the bullet last Sunday afternoon and...

Recordings of Fathers Blessings

Here are recordings of father's blessings that I gave to the kids this year and last. I realize I probably shouldn't post this online, so I originally made this post private, but then I just opened it up. I fear that if I don't post them here, I will lose these files. Fathers Blessings 2012 Fathers Blessings 2011 Fathers Blessings 2010

The Proximity Problem for Technical Writers

Last year I wrote a series of posts about moving from the sidelines to center stage. In the series I described how I transitioned from a low-key, hardly-speaking project member to a key player on the project team, someone with a voice that mattered in project decisions. But recently, with some projects, I've come full circle, moving back to that initial position of a fly on the wall. The changes had a lot to do with location. Previously, ...

Book Review: The Hunger Games, and a Possible Parallel for Technical Writers

The Hunger Games The Hunger Games, by Suzanne Collins, is one of the most suspenseful page-turners I've read in a while. I actually listened to it via Audible, and I was so pulled into the story that I found myself doing dishes, cleaning up, driving slowly -- anything so that I could prolong listening to the book. A couple of nights I stayed up past 1 am listening to it wide awake in bed, unable to sleep. In brief, the book is a dystopia...

Should You Get a Graduate Degree in Technical Writing?

Every so often someone asks me if they should get a graduate degree in technical writing. Penelope Trunk has a controversial post in which she argues that graduate degrees aren't necessarily smart business decisions. Graduate schools can be an environment that removes you from the world of real experience. Penelope writes, The biggest problem is that the degree makes you look unemployable. You look like you didn't know what to do abo...

Collaborative Post: Why Is the "Technical" More Important Than the "Writing"

I recently received the following question from a reader: The job listings on Indeed.com for local companies (in the San Francisco Bay area) all sound like they (or their recruiters) are really looking for engineers, programmers, web designers, or graphic artists “who write”, not for just straight technical writers who gather information, write it up, get it reviewed, and deliver it in whatever form it's needed (PDF files, hardcopy, onlin...

What Does It Mean to Know How to Write?

A lot of people feel confident in their writing abilities in an organization. And many times one's writing skills are perfectly suitable for the task. Other times they are hopelessly below readability. Why do so many people think they can write when they really can't? One reason may be context. A person may be skilled at writing e-mail, but writing an 800 word article is another matter. A person may be skilled at noting steps to reproduce...

My Review of the New Testament

Last year I wrote a review of the Old Testament. It was an off-topic post that I almost regretted posting, except that I did get a few comments from readers who appreciated my side jog because it showed I think about more than technical writing. This year I've been reading the New Testament, which is much shorter but also more challenging in some ways. I have a lot of thoughts on what I read, and a post like this is going to be hard howev...

Three Solutions to the Corporate Blogging Paradox

The corporate blogging paradox Corporate blogs suffer from an almost insurmountable paradox: you can write something interesting to readers, but it will make your company uncomfortable. You can write something that will make your company comfortable, but it won't be interesting to readers. The corporate blogger has a difficult decision to face. Do you want to gain an audience, build relationships with readers, and strike a cord of authent...

Book Review: The Lonely Polygamist, by Brady Udall

The Lonely Polygamist, by Brady Udall (published in 2010), is a masterpiece of a novel, pulling us not only inside a less than familiar family situation -- one of polygamy -- but also managing to connect the reader with universal family themes. Even if you've never met a polygamist (I haven't), there's plenty in here that any parent can relate to -- feeling overwhelmed by children, being pushed and pulled about by your spouse, sensing tha...

Interview with Kevin Cuddihy, Editor of the STC Notebook Blog

A couple of years ago, the STC started a Notebook blog. Recently I followed up with Kevin Cuddihy, editor of the STC Notebook blog, to see the impact has been for the STC. How long has it been since STC started their STC Notebook blog? It's been just over two years—our second "birthday" was on 3 August. The assistant editor for STC at the time, Tara Ebrahimi, started it. I came on board 31 August when Tara went back to school and picked u...

Stewart Falls: One Last Outing Before Summer Ends

On the last Saturday of summer, in a moment's decision, we decided to go hiking to Stewart Falls. Stewart Falls is right next to Sundance. The previous year we took another hiking trail that we thought would lead to Stewart Falls, but we were uncertain as to whether it was the real trail or not, and so we ended up turning back before reaching the falls. This year we took the right trail, and it was packed with people. We probably passed 100 ...