As my friends and family know, I’ve been mesmerized of late by a box of old letters I had stashed in my closet. The letters were from long ago – the late 70s and early 80s – before computers were in use, and definitely before e-mail.
The letters are a joy to read, as they recall wonderful memories and good times with people I’ve not seen in some time, or those I’ll never be able to visit again. Letters were often written over a period of days. Started, put down, picked up a different day. And then that was repeated, until the letter finally found its way to the mailbox.
In stark contrast to this is the technology of today: computers, e-mail, phones. We no longer write letters; we write snippets. In social media, we’re limited to the maximum character length allowed. Server capacity rules. Database limitations rule. Bandwidth matters. Plus we’re all in a hurry, so there’s not much time for reading, let alone writing.
How this applies to tech writing I haven’t completely figured out yet, but I have some ideas. I know content will be more snippet-like with quick delivery and review in mind. Finding, gathering, and monitoring the info is what will gain in importance. How much time will writers spend developing material, and how much time will be spent in searching the airwaves for existing material, determining what’s applicable and useful, and delivering it to users? How can we direct this burgeoning cloud of content?
Folksonomy – Taxonomy – Tags
Everybody puts some sort of tag on their content. Look at any post on any blog and you’ll see tags. What the tech writing community needs to do as a whole is determine some basic tags for all of us to use. This will ensure some consistency, make it easier for people to think of which tag to choose and then apply it, and provide more focused results listings. I’ll try to find some time to write a post and start listing some. Let’s get started.
Editorial Boards
Someone has to moderate all the user-generated content. The role of editor may be expanded from reviewing work of writers only. Writers will still need to prepare information of their own. They will also need to review what others develop to help ensure accuracy – to a point. They will undoubtedly need to look the other way at times, as the freedom to prepare one’s own information must be retained and to ensure that other points of view are represented. However, there will be times when it will be necessary to remove or delete some content. That’s where an editorial board comes in. Set the rules. Establish guidelines for submittals and content. Determine procedures for correcting or removing information. Establish your board now and get busy.
Make it Quick – Whip up a Video
Sure, there are times when it’s preferable to create a planned, long, official nice-looking online tutorial. Much of the time, though, I think you could just take out your little video cam and whip up a gem of a demo. Do we really need to have everything completely scripted and approved and run through the whole process? No. Definitely not. Not everything needs to be polished. Some videos could just be made in minutes and uploaded in seconds. They can’t – and shouldn’t – be too long in duration. For in-house uses in particular, it may be all that’s necessary. And if it’s wrong or outdated? Simply pull out the camera and make another one.
. . . . . .
After reading my letters, I’ve decided to turn off my computer sometimes and write some nice long letters to friends and family. I’ll save my snippets for another day. I don’t want to give up those snippets, but they’re like fall leaves being lifted off the sidewalk by cooling winds: there one moment, gone in the air the next. They’re meant to be momentary. Letters are meant to last.
Tech docs are not meant to last. The technology being discussed is changing so fast that the content is quickly rendered obsolete. People do not want to read that much any longer. We have to be fast, nimble, and prepared to gather, review, and move content quickly.