When you read something, do you hear the writer’s voice in your head?

That is, when you actually know what the writer’s voice sounds like.

I remember an assignment in a college writing theory class in which I had to discuss whether I have an inner voice when I read. I asserted that I do, one of my supporting points being that when I’m reading silently and come across a word I don’t know how to pronounce, I recognize that I don’t know how to pronounce it. If I were reading with no voice speaking in my head, I wouldn’t care about pronunciation.

I just wondered a few days ago whether I hear a coworker’s voice when reading her email or his IM. I think my inner reading voice isn’t even my own voice; it’s pretty neutral, while my speaking voice is in the bass range. It’s a similar voice, I think, when I’m reading coworkers’ messages. But still, I think there’s a hint of the person’s voice there.

Come to think of it, I don’t even think my thoughts are in my own voice, but rather in that same neutral voice. It calls into question the show and movie where someone’s thoughts are broadcast audibly, and people can recognize the voice. I wonder if that would really be the case. Since an unspoken thought doesn’t go through your vocal cords, how can it have your physical voice?

Okay, I’m done. Just one of those writing-related things that I started thinking about.

I mentioned the other day that I was working on some quick-start guides that a stakeholder asked for in our training structure. When he described something that he had in mind, I said to myself, “Quick-start guide.” This deliverable takes a different mindset than help systems or other types of documentation. I’ve decided that quick-start guides and quick-reference sheets must be a minimalist’s dream.

Read the rest of this entry »

Networking was a big emphasis when I was getting my technical communication degree. More than any of the other emphases within the English degree, the tech writing emphasis was geared toward preparing its students for entering the field. For technical communicators as much as many other professions, networking is an important factor in getting a job. With social networking sites, a new dimension of networking emerged.

When I had only a couple of months left in my internship at my church’s headquarters, the business analyst who had hired me extended an electronic invitation to join his network on LinkedIn. Because my future was uncertain and I needed as many ways to develop a network as possible, I created a profile.

I found out that many coworkers also had LinkedIn profiles. I connected with those I knew well, and I have tried to keep to that practice. The idea I get from the site is that its purpose is to connect people who have worked well enough with each other to be able to recommend each other to potential employers. Some people, however, seem to jump at any chance to build their networks.

Read the rest of this entry »

I’ve been a feedreader and blog hermit lately because I’ve been working on a couple of projects in my spare time. I’ve still shown my face (did I just hear a shriek…?) in the RoboHelp forums, mostly because it’s not a big time commitment. Get an email, go to the forum, give a reply, get on with life.

After a recent round of WebEx training on a Web application, one of our stakeholders proposed a different scheme for training. This application is going to go out to far-flung offices, and we see the potential for spending a lot of time training the staff. In addition, we tend to discuss peripheral issues and edge cases more than we should, lengthening our sessions.

The new scheme is to provide some quick-start material directed to the office staff roles. Then we’ll provide a menu of demonstrations done in Captivate. The demos will cover the “happy path,” as one of the managers calls it, rather than wandering off the main road into the dark woods and fields of tangentia (I think I just made that word up). Support for edge cases can come from the managing offices.

Next, we hold question-and-answer sessions by WebEx.

Finally, the stakeholder department will provide coaching and support.

I think this is a good approach for this particular situation. Quick-start guides or quick-reference cards may become a standard part of our deliverables. I and the designer on this project are going to propose a training page that is reachable from the landing page. The Captivate demos would open in modal windows. We have to pass it off through the project management, but I think with this new emphasis on training, this page will be added in.

To me, that’s one benefit of Agile development. If needs come up during a project, as long as there’s room in the budget, you meet those needs. We’ve seen a training need appear, and so we take care of it rather than ignoring it because it wasn’t in the original specifications or plan.

Right now, our team provides a selection of documentation deliverables to stakeholders. We have quite a list: online help (context sensitive or otherwise), quick-reference guides, animated demos, tutorials, manuals, and so on. In my opinion, documentation is not a once-size-fits-all matter.

However, the idea is to give the stakeholders guidance on what is appropriate for a particular project rather than letting them just pick and choose what they like. For example, as one project was being planned, I met with some of the project leadership and the main stakeholder, and at first the stakeholder wanted the same documentation products that we’d had in another project we did for him. This project was much less extensive and complicated, so I talked him down to something less grand.

Do you have a standard set of deliverables for the products you document (or manage), or do you offer a selection?

I received an email yesterday through a listserv that jerked me awake. In a discussion about which is more important when looking for a job, the skills or the tools, one person’s point in particular stood out to me. The respondent said that when you put the emphasis on tools and not skills, you get people who take a class on RoboHelp, for instance, and call themselves online help developers.

She said that she worked with such a person, and among the problems with this person’s products were “topics that require massive scrolling.”

Put me in the lineup, officer.

Okay, so I maybe I haven’t gone to the extent of committing a crime. But this comment directed my attention to a couple of topics in one of my help projects, and I set about fixing the problem immediately.

Read the rest of this entry »

On a day that is infamous to Americans, let us pay tribute to those who have lost their lives in order that we can remember the privileges that are ours.

Let us realize that it shouldn’t take a terrorist attack for us to feel united and to be united.

Let us look back and see how easy it can be within a matter of a few years to forget those things that should have changed us for the better.

Let us then remember and change.

May those who have given up time, safety, strength, limb, and life be honored on earth and in heaven for their sacrifices for their fellow beings.

May those who have lost their lives in defense of the United States of America and the freedom of the world’s peoples be borne to God as on eagles’ wings.