Cool Example of AJAX in a Blog -- Increases Usability

Scott Abel's The Content Wrangler has a cool example of using AJAX (asynchronous javascript) in his blog to increase usability. Kevin Shoesmith is the blog designer behind the Wrangler's makeover. I'm really impressed by the new site design, particularly the AJAX functionality. (Here's Scott's more detailed explanation of AJAX.) Overall the site looks more professionally organized and designed than it was before. The software running The ...

Is technical writing a calling or a job? Recommended DMN Communications podcast

After a five-month hiatus, Aaron and Scott at DMN Communications returned to the podcasting scene. In this Sep 9 podcast, they discuss whether technical writing is calling or just a job? By calling, they refer to treating tech writing as if you were destined to be a tech writer, as if it was a sacred duty you were compelled by almost a higher power to complete. Some writers exhibit this tech-writing-as-calling attitude by writing lavish...

Extracting information from SMEs

Sometimes I would like to change my job title from "technical writer" to investigative reporter, because so often this is the task that we have. Information we need is not online, not in any documents, not even available in the application itself. We have to pry it from the minds of subject matter experts (SMEs), the techies who talk in acronyms and dream in code. Surely one of the worst mistakes tech writers can make is to just stay in t...

Three new resources to check out

Occasionally people send me links to check out, and they encourage me to use them as fodder for my blog. I've let them build up a bit this past month. Here are three. (I'm copying and pasting from their emails -- I hope that's all right.) I haven't actually explored them yet, but some might be interesting. Let me know if you have any feedback. Scriblink "I recently launched a website that I think would be great on your blog. It's called ...

My online absence isn't a permanent vacation

It's been a while since my last post. Sure I've busy with the move and new job, but I've also just fallen out of the habit of blogging. I know blogging can be evidence of an active, engaged mind, so I don't ever want to give it up. Please don't mistake my absence for a permanent vacation. I'm just in transition right now and other things are on the forefront of my life. So where has my mind been? I've been learning a lot about storage are...

Thoughts on the Accumulation of Stuff [Junk]

I have been thinking a lot about how we accumulate an excessive amount of "stuff," which turns out mostly to be junk. I'm not afflicted with packrat syndrome. And scouting out good deals at garage sales is not my idea of a Saturday morning well-spent. In fact, I don't even have a garage, nor do I want one. Ninety percent of the people I know who own garages fill them with unnecessary items. Still, in packing and moving, I realized that we...

Closing One Chapter, Opening a New One

I know the title of this post sounds cliche, but it's how I feel. In 4 days, I'll be driving a 17 ft. U-haul towing a trailer minivan with 3 small children 2500 miles from Florida to Utah, moving into a little town, starting a new job, beginning so many things over. But during our three years in Florida, a lot happened in my life. I want to list them here so I remember. I arrived in Florida from Egypt after having spent 2 yrs teaching wri...

Rethinking the Importance of Screenshots, Diagrams, and Other Visuals

I used to think screenshots weren't necessary when it was obvious where buttons and other links were located. For example, if I wrote something like "Click the Subscribe to the RSS Feed link in the sidebar to subscribe to this blog's RSS feed," you'd think that people could easily follow this instruction. However, after watching user behavior, I have changed my mind. I now think screenshots are important to include even when interface el...

Tom is moving to Utah

I'm relocating to Utah in late August to accept a new job. I'll be working for EMC, which does contracts with the army base in Dugway, Utah. Dugway is about 80 miles southwest of Salt Lake City, remotely located in the Salt Lake Desert (see image below). We'll be driving over from Florida, which is about a 2,400 mile drive. We'll actually live in Tooele rather than Dugway. Tooele ("Tuwilla") is a small town (population = 30,000) about 45...

Gigzig: Shows Where You Were 5 Years Ago and Where You're Headed 5 Years From Now

Gigzig is a feature within Payscale.com that shows you where people with your same job title were 5 years ago, and where they are 5 years from now. It's a pretty cool before-and-after path to look at. The technical writing path is particularly interesting to follow. It seems that in five years, most tech writers either become managers or move elsewhere into IT. Gigzig explains how the arrive at this data: Every day many thousands of peop...

A Perfect Model for Online Tutorials -- MS Visio Shapes Course

This tutorial on Visio's shapes from Microsoft is the best online tutorial I think I've ever seen. If I were modeling my help after a perfect example, it would be this tutorial. Here's why: It contains both audio and text. You can control the audio easily, or just read the text. Each page is short (2 minutes) so your attention span doesn't time out. While you listen to the audio, you look at a graphic that demonstrates the concept expla...

Survey for New USF Tech. Comm. Program -- Would These Courses Create Highly Qualified Tech Writers?

If you've got a minute, please complete a quick survey about a new technical writing track that may possibly be implemented by USF (Univ. of South Florida). The survey's purpose: “We seek your advice on ways to provide the Tampa Bay area with more qualified, desired, and hirable technical communicators.” Survey link: ttp://CTLSilhouette.wsu.edu/surveys/ZS67087

Best Tech Writing Tip Ever: Watch a User Try to Follow Your Instructions

I once read an essay by Joseph Epstein in which he describes the glee and suspense in watching a stranger read his essay. It has happened to many novelists too -- the coincidental (dreamed-about) situation where you encounter a stranger reading page after page of your book, without realizing you're present. I had the opportunity to do somewhat the same today: to watch someone try to follow instructions in a guide I was writing. I learned ...

Grasshoppers that Look Like Aliens

June 2008 Update: I know you probably found this post by searching for the word Grasshopper. Feel free to save this grasshopper image and use it however you want. I don't know the official name of the grasshopper, but I took the photo in St. Petersburg, Florida. I then removed the background in Photoshop. If you know the specific species name of this grasshopper, let me know. This beautiful grasshopper was hanging out on our patio wall al...

Small and Simple Things -- The Best Kind of Goals

I was reflecting today on Avery's love of reading. When Avery was a baby, Shannon and I had a goal of reading her 3 books a night before bed time. We thought it would be a good idea, and this goal turned into a habit and routine that we have kept up over the years, for the most part. I've watched other parents put their children to bed in 5 minutes, not reading them anything. Now that we've been reading to Avery at bedtime for nearly six ...