Develop Your Own Powerful Story

When (or if) you tell somebody that you’re a technical writer, do their eyes glaze over? Do they look at you quizzically and say, “So, what does that mean? Do you actually write ‘Click here and press Enter’ all day long? What do you actually do?”

You can answer questions like that by articulating what STC Executive Director Susan Burton calls “our powerful story” about technical communication. In my Spring president’s message to the SWO chapter, I encourage chapter members to follow Susan’s lead and remember their powerful personal stories:

Believe it or not, you have a story.
Your past and present professional activities have made and continue to make a difference. Your communication skills improve your company’s bottom line. Your manuals make the company’s products easier to use. Your safety guidelines save lives. Your procedures keep company officers out of jail. You have an impact.

Actually, we all have many stories. Here’s one of mine (in the words of an appreciative customer):

To help us fix a not-very-good website, Judy came up with a website that is well organized, comprehensive and easy to use… much better. It can now be used by customers to research and understand the service offering AND it can used as an online “manual” for our service personnel. This site is the best example of this type of technical documentation resource that I’ve ever seen.

The story behind the story? Hours spent trying to:

  • Unravel the convoluted workflow procedures that were kinda sorta in place
  • Locate authoritative versions of forms and approval documents that had to be completed and filed
  • Find answers to the unanswered questions that came up every time a customer tried to work with the service, and
  • Organize all the customer-required information online in a clean, uncluttered, easily accessible format.

So what do I do … in thirty seconds or less, I verify and streamline company procedures to make sure that employees can execute them and customers can understand them.

What about you? What are your stories? Dredge them up and distill them into a paragraph or two. They’re bound to be fascinating. So … Tom Johnson, Monkey Pi, Holly Harkness, Mike Hughes, Frank Girolami … all you techwriting bloggers out there –I read your blogs and I want to know: what are your powerful stories?

[tags]STC, Susan Burton, technical writing,stories,marketing[/tags]

How to Carry a Portfolio in Your Pocket – and Why

You never know when you might need an easily portable online portfolio, do you? Maybe at a technical conference ….

A business card dropped face-up on the laptop keyboard. Chelsea glanced at the name on the over-sized square — ProteoLogix — and looked up at the woman standing in front of her. “Pretty impressive card,” she said. “Must weigh almost an ounce. I hope you don’t carry more than two or three of these at a time. Bad for your back.”

Opportunity Knocking
“Ms. Jackson. You made several interesting comments in the Crystal Room Content Management seminar. About the tradeoffs involved in managing research, procedural, and marketing information for a fast-growing tech startup. Have you ever actually done what you described? ”

“Dr…” Chelsea checked the name on the card, a little annoyed. “Kravinzki, is it? Excuse me, but who are you? Have we met before?”

“No. But we need to talk, and I haven’t much time. Let me give you a quick rundown of what I’m looking for. ProteoLogix is developing a series of products to provide quick diagnostic profiles for patients with diabetes-related complications in urgent care settings. And we need to come up with a way to manage the tons of data our researchers generate every week. To store it, retrieve it, track it, distribute it to the right people, publish selected pieces of it in the right places, and God-only-knows what else. Have you ever worked in a setting like that?”

Opportunity Recognition
Oh. ProteoLogix. The well-financed, extensively publicized biotech startup that was bound to go public any month now. That ProteoLogix. Chelsea stood up, considerably less annoyed, and extended her hand. “Good to meet you, Dr. Kravinzki. Won’t you sit down?”

Opportunity Challenge
“No time. My plane leaves in three hours, and we’re 30 minutes from the airport. I’ll give you 15 minutes to convince me that you can help us with our data explosion. That is, if you’re interested…”

There it is. Chelsea’s trapped on the edge of a cavernous exhibition hall, in a WiFi-free zone, with anything remotely resembling a portfolio at least 10 or 12 minutes away, in her room on the 75th floor. What will she do?

Opportunity Seized
Chelsea sat down with Dr. Krivinzki, located one of her laptop’s USB ports, and inserted the 2GB WOS (Webserver on a Stick) she always carried, the stick where she had thoughtfully installed a series of prototype content management systems, including one with a sample biotech taxonomy. Ten minutes later, she had a verbal commitment and an appointment at ProteoLogix’s Boston campus. Nice save!

What is WOS?

wos

  • The basic version (WOS Portable) is free and open source, released under the GNU/GPL.
  • WOS Portable comes with a selectable bunch of preinstalled software, including
  • WOS Portable works well for online content writers who have to present their work in situations where connectivity is limited.
  • WOS works on any post-Windows 98 box with a functioning USB port.
  • Installation is painless. Check out the WOS Mixer download page.

Any limitations?

  • Not so promising for sites based on Active Server pages. (I haven’t tested this, but It seems reasonable for me to assume that this Microsoft technology might not play well on a stick with its open-source neighbors.)
  • On boxes with USB 1.1 ports, things run very slowly. For reasonable speed, stick to USB 2.0.
  • It’s best not to use the standard webserver port (80) for WOS, so that WOS doesn’t collide with a possible webserver installation on the host computer. The WOS wiki provides instructions for changing the Apache port.

Will it work for you?

For the cost of a 1GB USB stick (which can be had for less than $30) and a few hours of investigation, you can add a pocket-sized web project portfolio that may help you seize an unexpected opportunity. If you decide to try WOS, please let me know how it works for you.

[tags]webserver on a stick,WOS,portfolio[/tags]