Idealism & realism  Clip to Evernote

Recently, I had an interesting conversation about a variety of things with another technical writer. During the conversation, he kept insisting that technical communicators need to move to formats that can be viewed on mobile devices. And that we need to do that now.

My response was that this was a good idea, but not-so-good in practice. Without even waiting for me to elaborate, he called me a dinosaur and a Luddite. I called him something that was less than nice …

Let’s get this straight: when it comes to smartphones, tablets, and other mobile devices I don’t fear them and I don’t hate them. In fact, I’ve been using and writing about them for longer than most.

Yes, it’s true that people are (in the words of many others) consuming more and more content on mobile devices like smartphones and tablets. And, yes, you need to know your audience.

But until your customers actually start issuing those devices to employees and those employees actually use them to read documentation, then shifting to mobile formats is nothing more than a nice idea.

Building mobile-enabled documentation won’t make customers buy and deploy mobile devices. They need a bullet-proof business case before they do that. And, of course, the budget. Study after study can say that by whatever year, x% of content will be accessed using a phone or a tablet. For many technical communicators, the content that they’re producing won’t make it on to those devices until customers adopt them. With many businesses, that can be a long time in coming.

What to do until then? Definitely don’t ignore the mobile/portable space. Understand the issues surrounding how to create documentation for viewing on, and for use with, those devices. Understand the tools and the techniques. Be ready for the change. It will happen, but chances are it won’t happen as soon as many people think. That said, it could happen sooner than you expect if you jump to a new job or gig!

Thoughts? As always, feel free to leave a comment.

Photo credit: air from Photoxpress

Is indexing dead?  Clip to Evernote

by: Julio Vazquez

Dynamic web, taxonomy, folksonomy, collaboration, semantic web, SEO, and many other terms are used in the technical communications community to describe methods to help readers find content on the web.

The technical advances that allow someone to locate information on the Internet have improved greatly over the years. The fear of getting lost in space that was the dread of technical communicators is, for all intents and purposes, a wild nightmare of an older generation. There is no fear of indiscriminate hyperlinks because the professionals follow best practices when creating those topical relationships.

Discussions now center about how to provide the right set of keywords so content for a product or service is listed early in a set of search results. Predictive search has become the latest concern amongst the knowledgeable folks in the business because how someone seeks knowledge may be altered by the algorithms used to create the prediction.

Continue reading

Three simple and subtle ways to improve your writing  Clip to Evernote

Although I’ve heard one or two people argue otherwise, writing is one of the essential skills for the technical communicator. In fact, you can safely say it’s one of the core skills you need to succeed in this wacky profession. No matter if you’re writing procedures or creating a screencast, you need to be able to write clearly and concisely to be effective.

Our writing can always use some work. I’m not saying that you can’t write. Far from it. In fact, I’m sure there are any number of people reading this post who can write better than I can. But no matter how good you are (or think you are), there’s always room for improvement.

It’s hard to count the number of paths you can take to improve your writing. Most of the ones that people tend to focus on tend to require a lot of effort and concentration. Nothing wrong with that – learning to write well isn’t an easy task.

But there are many other ways in which you can improve your writing. They don’t take a lot of time, aren’t difficult, and can be done just about anywhere and at any time.

Here are three simple and subtle ways in which you can do just that.

Continue reading