Category Archives: Value

Carrying the earth on our shoulders

At last week’s STC Summit, I attended a couple of presentations that probed the same question. It’s an old question, but it’s still a thorny one.

atlas_rockefeller_center

I used to see this guy on childhood trips to New York. Now he reminds me of my Tech Pubs colleagues.

How can we integrate content into a unified presentation when the content comes from all over the place? When different teams — communication specialists and nonspecialists — are creating content using different tools and different styles, often with different objectives in mind, how can we present it to customers as a unified whole?

Both presentations showcased successful case studies for integrating content. Both placed the Tech Pubs department at the center of the action. Yet both left me wondering why this whole thing — integrating content produced independently and content produced as part of a collaborative effort — isn’t easier. Continue reading

The linchpin of inspiration

Author and storyteller Carla Johnson, in her keynote speech at this week’s STC Summit, described how inspiration comes, not as a bolt from the blue, but from observing other people’s creative work. She warned against brand detachment disorder, in which we see another brand — maybe Disney or Apple — doing something cool but immediately dismiss it because it couldn’t possibly bear on our own company’s brand.

photo of Carla Johnson

Carla Johnson

Instead, Carla charged us to observe what other brands are doing, distill the parts we can use, and relate those parts to our own brand and customers. Then we can generate ideas and pitch them to our bosses. Call it the inspiration process.

That’s what Rachel Sparks, Technical Director at Xenex, did. Xenex makes robot-like machines that hospitals use to disinfect areas where patients are treated. This is a very big deal, because it drastically reduces the threat posed by sepsis and other infections. When Sparks noticed that some hospitals were giving their machines whimsical names and putting Santa Claus hats on them, she saw a way to market her company’s product not as a machine but as something that touches people’s hearts.

That’s great creativity, great marketing. But is it technical communication? Did Carla get mixed up and think that she was speaking to the Society for Technical Marketing?

No. Carla knew exactly where she was. Continue reading

At the 2018 STC Summit

STC Summit logoI’m writing live this week from the STC Summit. Are you here too? If so, are you finding the experience worthwhile?

Take a moment to answer the following question. Then use the Comments section to tell me why you answered as you did. (Your vote is anonymous; your comments are not.)

If you’ve been to previous Summits, tell me how this one stacks up against those.

I’ll be back in a few days with my impressions from the Summit. But first, I want to hear from you.

Lightweight DITA: I’ve seen the light

DITA logo being held aloft by balloons

Lightweight DITA doesn’t have a logo yet. The technical committee is welcome to use this one.

If you’ve taken one of my DITA classes, you’ve heard me extol the power of DITA. One aspect of that power is semantic tagging. In DITA, a piece of content isn’t boldface or italics. It’s a command name. Or it’s a citation to another document. Or it’s the name of a screen (a wintitle, in DITA parlance).

That’s a big selling point for DITA, you probably heard me say. Each DITA element represents what a thing is (hence the term semantic) rather than how it looks. Just think: you can take a big document and generate a list of all the command names, or all the screen names. You can’t do that when you’re just tagging things as boldface and italics.

Turns out there are a couple of problems.

  • First, I’ve never met anyone who wanted to generate a list of all the command names, or all the screen names. While it sounds good in theory, in practice it’s more like a solution in search of a problem.
  • Second, it’s a lot to remember. When is a command parameter a parameter? When is it an option? (DITA has tags for both.) Writers working side by side, writing content for the same help system, might tag the same object in different ways.

Just now, in fact, as I wrote this article, I couldn’t remember the name of the tag for citations. Even though I’m accustomed to using it, I couldn’t retrieve <cite> from my brain. I had to look it up.

Enter Lightweight DITA. Continue reading

Launching your technical communication career

Last time I wrote about the places you can go, or the different trajectories your career can take, when you work in technical communication.

But how do you get that first job? What qualifications do you need, and what are employers looking for?

Prompted by interview questions from a Tech Comm graduate student, and based on my experience working in the field and interviewing candidates, here are some thoughts.

montage of album covers from 1979

We listened to different music in 1979, and breaking into the field was different too.

I got my first technical writing job a long time ago — in 1979. One thing I know for sure is that your breaking-in story won’t be the same as mine. Things were a lot different then, and I’m not just thinking about the music we listened to. Companies, having realized that technical people didn’t necessarily make good technical writers, went looking for young writers who weren’t necessarily versed in the technology but who could learn it.

Armed with a double-major in English and philosophy, and having a tiny bit of experience with computers, I landed that first job with IBM.

You won’t have the same experience. Your résumé will need to look a little shinier than mine did.

What are the educational requirements for working in Technical Communication?

Follow-up question: Are certain degrees or backgrounds more sought after by employers? Continue reading

Why your idea didn’t fly — and how you can give it wings

Roseate Spoonbill in FlightRemember that great idea you had at work? You knew it would make a huge difference for the company and its customers, that it would pay dividends long into the future.

You pitched it to your boss, or to the C-suite. You put everything you had into it. But they just yawned. Nobody caught your enthusiasm. Worse, when a different, shiny idea caught their eyes, they forgot all about your idea and backed that one instead.

What happened?

Seth Godin provided some answers in his blog this past Super Bowl Sunday. Seth examined why cities spend hundreds of millions on stadiums while projects with a better return on investment — like building roads, improving education, or investing in technology — go wanting.

Learn the dynamics of corporate decision making

Seth sees 5 dynamics at play in decision making at the city or state level. I’m convinced that they also bear on your situation at work.

  • The project is now. It’s yes or no. There are no subtle nuances, no debating the pros and cons for years. We either build the stadium, or our team moves to Vegas.
  • The project is specific, easy to visualize — in contrast with, say, “investing in technology,” which each person is likely to visualize differently.
  • The end is in sight. When you build a stadium, the stadium opens and games are played. With other projects, it’s often harder to visualize the end state.
  • People in power and people with power will benefit. Enough said.
  • There’s a tribal patriotism at work. “What do you mean you don’t support our city?”

So what was your idea? Were you proposing that the writing team embrace structured authoring? Did you want the company to adopt a content strategy?

Why did your bosses toss your idea aside? Maybe you didn’t frame it in a way that took the 5 dynamics into account.

Make your idea fly

How can you improve your odds when it’s time to sell your next idea? Ask yourself these questions.

  • Is it clear cut? Can I create an unambiguous, shared vision in everyone’s mind of what will happen if my idea is adopted — versus what will happen if it isn’t?
  • Can they visualize the results? It might help to tell a story: meet Joe, who just bought our product. Here’s how my idea will improve his life and turn him into a more loyal customer. Or here’s Sally in Tech Pubs, and here’s how she’ll be able to create better content for Joe and others like him.
  • Is the end in sight? Can I describe what the results will look like in a year, or in 2 years? Or am I trying to sell something that brings only gradual improvement? Similarly, can I describe the win criteria: what specific things need to happen for this project to be measured as successful?
  • What’s in it for the executives? This might go against my altruistic nature, but the bosses won’t really listen (although they might pretend to) unless they see some benefit, tangible or intangible, for them.
  • Am I appealing to company spirit? Can I paint a picture of customers waving banners with the company logo, or of the CEO on a stage talking up this idea before a cheering audience?

Try framing your next idea around these dynamics, and you might see a better result. Because people are people, whether they’re a city council or the C-suite at a corporation.

Don’t give up

anoseate Spoonbill, Birding Center, Port Aransas, TexasYou’re probably thinking: my idea can’t score on all of these criteria. By necessity, it’s a long-term solution with no clear-cut success criteria. Or it addresses issues that are internal, “under the hood” — nothing that the CEO would ever talk about onstage.

In that case, go ahead and pitch your idea anyway. Just be aware of the forces that are at work, and be willing to address them. “I know this isn’t something we’ll be able to tout to our customers. But you (Mr. or Ms. CEO) will have the satisfaction of knowing that you’ve made your employees happier.”

Seth, unfortunately, used the word losers in the title of his post. He was saying, I think, that basing decisions on those 5 dynamics is a losing proposition — that cities would see better outcomes (better infrastructure, better education, better quality of life) if they could get past the limitations imposed by the 5 dynamics.

I look at it differently. I prefer to say that Seth has shed light on some basic aspects of human nature. Rather than simply abandoning our less-than-shiny ideas, we can succeed when we understand those aspects and turn them to our advantage.

What do you think? Has Seth given you a way to bring your ideas to fruition, or has he convinced you that your ideas will never gain traction?

Can you share a story of when you got an idea approved by appealing to these aspects of human nature?