Category: Training

Categories
Computer Languages Language Training Uncategorized

How the Audience Affects Technical Communication

Paul Clifton is a Ph.D. student in Digital Media at the Georgia Institute of Technology. He has been an on and off technical writer with Shoap Technical Services since 2007 and is currently working in interaction and user experience design at Intel.

Recently, I helped my friend update his resume. I’d helped him make a brand new one a few years before, and it had been an extremely painful process, so when he asked me to help update it, I nearly just said no. To my surprise, the draft he sent me proved that he had been paying attention when I had originally explained the rules for making a good resume, why they were the rules, and why following them mattered. His grammar and spelling still weren’t very good, but grammar and spelling are the easy part. Clearly communicating complex information by meeting the expectations of the reader is the hard part, and I was happy to see that he had pretty well taken care of that.

Continue reading “How the Audience Affects Technical Communication”
Categories
Business Humor? Networking Training Uncategorized Water Cooler Stuff

Summer Reflections of an Intern

By the time you enter the 3rd grade, you know what summer is. It’s that time of year when you don’t have to go to school or do homework. Instead, you can just play all day with your friends, go on vacations, watch TV, or anything else you’d like to do. Summer is always a time of relaxation, an unwinding from all the busyness and tension of the school year—even at the age of 7. It’s exactly what summer should be—lazy and carefree. Summer break is a break for a reason, right?

Continue reading “Summer Reflections of an Intern”
Categories
Computer Languages Process Screencasting Tools Training Uncategorized Writing

How Waterfall/Agile Development Impacts Technical Writing by Eric Sedor

“Waterfall is dead, long live Agile,” many voices cry, heralding a transition in the software industry from heavyweight engineering efforts to an almost sports-like scrimmage. Waterfall didn’tkeep up, they complain. Projects turned into congested pipelines and out of desperation to reclaim fluidity, the entire cycle broke down into an environment of iterative re-development that gave birth to Agile. Increasingly, developers collaborate in short sprints to rapidly address evolving concerns rather than as construction crews working from blueprints. What does this new era mean for technical writing as part of software development? More specifically, what is expected of an Agile Technical Writer?

Continue reading “How Waterfall/Agile Development Impacts Technical Writing by Eric Sedor”
Categories
Process Training Uncategorized Writing

Why Technical Writers Scroll

In a recent issue of the Shoap Technical Reader, I commented on my reaction to a usability test in which I had participated (“Why Technical Writers Are So Weird”). The test was for one of our writer’s web UI development classes. He created an application to create a response to an RFP. His observations can be found here: http://superawesomegood.com/2012/03/31/searchers-and-scrollers/.

Continue reading “Why Technical Writers Scroll”
Categories
Business Marketing Process Tools Training

What Is Gamification?

You may have heard the term “gamification” floating around and wondered, “What is that?” The answer: Gamification is the new buzz word representing the idea of incorporating gaming concepts and techniques into non-game activities in order to drive a desired behavior. Marketing campaigns can use game mechanics to drive customers to their websites, sales agents can participate in games to drive competition and increase sales, and in our industry, documentation and training groups can build game-like training materials to fully engage the learner.

Continue reading “What Is Gamification?”
Categories
Business E-mail Language Marketing Networking Tools Training Uncategorized Visual Aids Water Cooler Stuff Writing

MS Paint can be very useful

I used to take Microsoft Paint for granted. I saw it every once in a while in the Accessories folder when I was looking for the Calculator or Notepad but never really used it. Then I starting using screen capture programs at work to take screenshots for user guides, manuals, online helps, etc. When I was on my personal computer, I had no idea how to take a screenshot without a fancy program, and then I finally remembered Paint. Since then, I’ve used it for screenshots, creating and editing pictures/photos, and testing.

Continue reading “MS Paint can be very useful”
Categories
Business Language Marketing Networking Tools Training Uncategorized Useful Links Writing

Do you know about Wikipedia’s Simple English?

I don’t know about you, but I’m constantly Googling anything and everything and I frequently end up on Wikipedia’s website. One day I was looking at all of the possible languages I could read an entry in and noticed “Simple English” was one of the options. I was reading about something complex and “Simple English” simplified the topic and made it easier to understand (you could say it’s a “red carpet” to the “English” entry).

Continue reading “Do you know about Wikipedia’s Simple English?”
Categories
Business E-mail Language Process Tools Training Uncategorized Writing

How Documentation Can Create Trust

When you are a company dealing with your customers’ most valuable personal information, you need them to trust you. One easy way to do this is to have your documentation flawless (or close to it). Also, performing a test run with a small group of people before releasing it to the masses is a good idea. The group of people should be 3rd party users who can find the mistakes you can’t find (since you’ve read and reread the form 40 times and never want to see it again).

Continue reading “How Documentation Can Create Trust”
Categories
Process Tools Training Uncategorized Visual Aids Writing

Reading Images

There is an unfortunate trend towards using more images and icons and using fewer written instructions (I like to say “words”). Personally, I don’t think it’s obvious what every icon actually is and what it means, especially when I’m in a hurry to do something.

Continue reading “Reading Images”
Categories
Business ROI Screencasting Training Uncategorized Writing

Showing Returns on Your Documentation Investment

Hello again readers!  Last time we “met,” I had the pleasure of walking you through a quick primer on the Kirkpatrick model and how to best use it to assess the effectiveness of a given training program or set of training materials. My main argument was – whatever you do – make sure to focus on metrics that allow you to show measurable positive impacts that can be easily translated into $ savings. The bottom line is… well, that’s what your manager will be looking at, the bottom line. What’s the return on this documentation investment? At the end of the day, how many dollars does it put back in our pocket?

Continue reading “Showing Returns on Your Documentation Investment”