January 31, 2016

Springboarding and Radical Flexibility in Technical Communication

Posted in Commentary, Content Strategy, Disruptive Communication, Documentation, Knowledge Management tagged , , , , , , , , , , at 3:44 pm by degyes

This morning, I did something that I do rather infrequently. That is, I responded to a research survey, this one being conducted by a tech comms professor at a college in New Mexico. The request was to list—in the respondent’s opinion—the most important trends, technologies, and theories impacting the tech comms field over the past five years (with a limit not to exceed ten items).

Having been mostly out of the field for the past almost three years, since transitioning to the financial side of the technology sector, I realized my response might be perceived as a bit presumptuous. Though once I got beyond that initial reluctance, and betting I’d have what to contribute, my thought process got itself into gear. Then, as I started putting together my list (some of which I realize—like outsourcing and apps—are no-brainers), it got me thinking more deeply about the issue of surviving in the brave new world of off-shoring, crowd-sourcing, and rapid paradigm shifts. Which led, in turn, to my evolving theory regarding ‘springboarding’ — or, radical flexibility—as a job survival and career development strategy.

So here are my top 10 items for what we should all be maintaining in our field of awareness as we courageously plow ahead into the ever-changing, but always essential, professional practice of sharing knowledge with those seeking answers.

  • Off-shoring, meaning, expand and deepen training in order to keep US-based TC’s relevant in current market.
  • Outsourcing, similar to above, though focused on “manpower” firms as the competition as opposed to overseas TC’s.
  • Crowd-sourcing, meaning, forcing the question as to ‘why do I need in-house TC’s if the customer will anyway Google their questions’?
  • Cloud-based documentation, meaning, ability to host documentation in a highly modular fashion where updates can be made on-the-fly and in a way that’s transparent to the customer or end-consumer.
  • Video and animation. YouTube contains lots of real gems, offering ‘how-to’ instructions for everyday applications like Word and Excel, as well as for specialized and highly-specialized solutions. Screen-cam tools enable reasonably quick creation of animations and storyboards that have replaced more “traditional” text- and still image-based documentation. These skills are must-haves for today’s TC.
  • Single-canvas presentation solutions (for example, Prezi), which have made fast-paced animations another need-to-have skill for TC’s. (I actually prefer to call these tools “infinite canvas” or “non-linear object path.”)
  • Documentation on-the-go, meaning docs — or any information —consumed via apps.
  • Metrics, that is, the demand for TC departments, teams, and individual practitioners to prove their added value by demonstrating statistically how documentation products and services contribute to the bottom line.
  • Agile methodology, which is a whole philosophy, but I’m referring specifically to having the customer or end-consumer play an essential role in the feedback loop that impacts the documentation that the software (or any product or service) provider delivers.
  • DevOps, which is another whole philosophy, but I’m referring specifically to TC’s needing to keep up in an environment where continuous development and continuous integration rule the day.

In closing, I’ll add that perhaps the most important item, not included in the list above, is what I would call spring-boarding or perhaps “radical flexibility;” that is, the awareness that your professional practice is likely to change considerably in tone and in scope every two or so years, and could even become completely unrecognizable and in need of swap-out after three to five years.

Wishing us all much success as we go forward.

-Dave Egyes



February 22, 2012

A Comic Alternative to Documentation?

Posted in Disruptive Communication, Documentation, Information Architecture tagged , , , , , at 9:28 pm by degyes

Recently, when clearing some bookshevles, my wife came across this illustrations-only set of instructions she’d prepared back in the late-90’s for our then pre-literate daughter, who’d demonstrated a propensity for (supervised, semi-independent) baking projects.

Having a fresh look at these instructions got me thinking about the use of comics and pictures-only documentation for non-literate and pre-literate users. In this case, the images are rather high-context, meaning, they might be meaningless to someone not familiar with the kitchen for which they were drawn, the equipment being used, and the end-product, in this case, popovers.

However, I can validate (or at least visually confirm) that these instructions—with a bit of practice—did in fact work. Our daughter, a pre-schooler at the time, indeed managed to create the intended product, based on following the image sequences in the drawings.

In the years since, I’ve come across a number of instances where a hardware vendor or app provider chose to rely mainly on illustrations, sometimes accompanied by text, other times relying only on pictures, in providing instructions for end-users.

Though I’ve yet to research the topic in-depth, I find the basic notion intriguing. That is, do we tend to be over-reliant on words, in cases where simple drawings would do the trick? Could we, as documentation specialists, make our instructional products more accessible to those who either have difficulty reading in general, or who aren’t familiar with the language(s) in which we provide wirtten documentation? Instead of—or more likely, in addition to—translating documentation into written languages, could we transform our instructions into comics or other illustrations-only media?

For what it’s worth, since I’m not a big fan of pudding-like baked goods, I’ve never actually tried the end-product. Nor am I a “foodie” or sharer of recipies (I tend to overlook such posts in Facebook and instantly delete them from email). Though if you decide to try applying these instructions at home, I’d be curious to hear about your outcome, as well as learn about your experiences with comic-based documentation.

June 5, 2011

Authority & Identity in the Internet Age

Posted in Disruptive Communication, politics, society tagged , , , , at 10:25 pm by degyes

[This article was co-posted to The Disruptive Communicator]

Here’s my tweeted super-brief summary of Jeff Jarvis’ Buzz Machine article “e-G8: A discussion about sovereignty” (see tweeted links below), which presents his exploration as to what extent the Internet can change not only traditional loyalties and identities, but the very nature of how authority can be applied by governments in the first place. While the jury is still out on what direction and form this “new” authority will take, it’s certainly worth noting, especially now that French President Nicolas Sarkozy has apparently taken a keen interest in the issue.

[1/5] Liked @JeffJarvis’ description of the Internet as disruptor of authority.  http://bit.ly/kHRBT1

[2/5] Can the Internet serve as a counterweight to power & authority of gov’t?  http://bit.ly/kHRBT1

[3/5] The question as to who has sovereignty over the Internet is still being debated.  http://bit.ly/kHRBT1

[4/5] To what extent does the Internet undercut traditional loyalties?  http://bit.ly/kHRBT1

[5/5] Is Internet really akin to 8th continent? Are we dual-citizens of countries & the ‘Net?  http://bit.ly/kHRBT1

May 16, 2011

What Would YOUgle Do?

Posted in Book Review, Disruptive Communication, Social Media, technology tagged , , , , , , , , , , , , , , , , , , at 3:33 pm by degyes

Our recent reading of Jeff Jarvis’(@JeffJarvis) 2009 critically acclaimed – and sometimes ridiculed – What Would Google Do (#WWGD) stimulated much thought with regard to the tectonic shifts taking place in business during the past fifteen years or so. There are many reviews out there of this book, laudatory as well as mocking. Go ahead and Google them. So why the need for yet another? We decided to present a review targeted toward technical communicators (TCs), a professional group impacted heavily by the Internet economy, and also well positioned—possibly better than any other profession—to exploit these shifts.

A Media Experiment

One of Jarvis’ stories that stood out powerfully for me was his retelling of a media experiment by Brian Lehrer in 2007. On Lehrer’s WNYC radio program, he prompted listeners to go to their local grocery stores and report on the price of milk and several other items. Hundreds responded, providing the station with data no single reporter could have gathered alone. WNYC plotted the data on Google Maps, demonstrating which neighborhoods were being gouged, and even being subjected to illegally high prices.

Why should this be surprising and what’s special about it? Haven’t consumers banded together for ages already, supporting the businesses, products, and services they like, while spurning those they don’t? Yes, but not with such rapidity, ease, and perhaps boldness. Could this experiment have succeeded without Google Maps? Maybe. But the point is that the Internet and a (free) Google product make the collaboration effort much easier and much faster. Furthermore, if it could happen in a few shops in several New York City neighborhoods, could this experience be scaled to a whole state, country, or industry?

Riding the Cluetrain

Jarvis is clearly a proponent of the Cluetrain Manifesto, as he refers to it with some frequency. Furthermore, his main message is very much in alignment with Cluetrain’s principles, as well as its tone. Written in 1999, Cluetrain lists 95 statements (“theses”?) on how the Internet has changed, and is continuing to change, the way the world does business. Namely, it describes how the consumer is empowered through a vast network of people sharing their stories about products and services. Marketing departments and many of the techniques they’ve employed, Jarvis says, are becoming irrelevant and are outmoded. Companies had better tune into the conversations taking place “out there” among consumers and other interested parties that could lead to potential business.

Though written in a somewhat smug tone, Cluetrain contains truths that we ought to internalize. Specifically, what are the key lessons of Cluetrain, as exemplified by Google’s success story? What can we learn here? The take-home message is that product vendors, service providers, and professional people in general—anyone wishing to remain relevant in the public sphere—must place listening to customers and responding respectfully to their input at the foundation of their organizational culture.

You’re Tweeting? So? Are You Listening?

Taking it a step further, Jarvis’ urges avoiding the delusion that having a Web site or being on Facebook or Twitter makes you customer-oriented if your basic behavioral pattern hasn’t changed. Talking down to your public is not only passé, but destructive to your business. Listening goes beyond claiming to have a customer service culture or exuding warmth in your PR campaign. What it does mean is that the products you sell and the services you provide reflect the needs, expectations, and input of your public.

On rare occasion, a product, service, or platform will come along presenting a quantitative shift in the way we do things. It could be argued, justifiably so, that revolutionary changes—mass produced automobiles, telephones, Internet, Web 2.0 applications—were so innovative that they couldn’t possibly have been invented only in response to consumer surveys. On the contrary, these innovations were truly ground-shifting, imaginative, and bold. They’re also quite rare. As consumers, we’ll know one when we see one. In the meantime, just listen.

So What’s the Message for Technical Communicators?

Why do we as TCs need to pay attention to Jarvis’ message? Why can we not afford to ignore the communication frameworks—and the documentation models—emerging as a result of the Internet economy?

The top-down approach to documentation is rapidly becoming outmoded; many would say it’s already gone. Instead, we need to be thinking in collaborative, grassroots, “distributed,” ways. According to Jarvis’ Google Rules for media companies, “thinking distributed” means regarding your readership—i.e. your customers—not as mere consumers of your output, but as content sources themselves. This is already happening across countless support forums—Nokia, Microsoft, Adobe, travel tip sites, are just a few that come to mind. If it hasn’t reached you by now, bet that it will soon. Open up and listen.

What does this mean for us? What do we need to do? Get involved in what’s happening on the ground level. Participate in these conversations. Read what’s being written. Be open. Be responsive (not reactive). Lead discussions. Harvest the knowledge that grows from these interactions. Tag it. Curate it. Repackage and productize it. This is your documentation. This is your product, and your portfolio.

Me? Blog?

Why do people blog? Perhaps the better question is why do professionals blog? Why is it important for us to place ourselves out there before the public? Because, if done well, it conveys that message that we care and that we’re eager to engage our audience and customers face to face.

We believe this message applies to all types of social media, including—but not limited to—blogs. As such, a well-thought social media image addresses the following questions:

  • What is our contribution to the “gift economy”?
  • What is our value proposition?
  • How do we differentiate—i.e. brand—ourselves?

Oh, and if you have to explain your value, it’s probably not as great as you think.

Old Media, New Media

According to Jarvis, Yahoo is the last “old media” company. That is, Yahoo is a portal, a Grand Central Station of online resources. Thus, Yahoo is a manifestation of what Jarvis calls the content economy, which is outmoded. Google, on the other hand, is—claims Jarvis—the first post-media company. Meaning, Google is a platform (not a portal), a network, and is decentralized and distributed. Google trusts and respects people, or at least (says Jarvis) manages to project that attitude. Google exploits the wisdom of the crowd. And what’s more, Google opens up endless choices and possibilities via search, SEO, and AdSense. Whereas Yahoo is a remaining manifestation of the content economy, Google leads the link economy.

The link economy demands that we—companies, groups, and individuals—produce unique content with clear value. Beyond that, we need to remain open so that Google can find us. That is, we’re to let Google exploit—through advertising and promotion—the links and audience that we acquire. Furthermore, we have to use those links to create new efficiencies (“do what you do best and link to the rest”), and find opportunities to create value atop our link layer. This means curate the best content, enable your links to be found, and help content creators monetize—or otherwise promote—links, and in turn, attract traffic.

Are You Drinking Google Juice?

Google juice is what we want. It gives us better ranks, more ads. It will, according to Jarvis, net us more money. To get Google Juice, you’ve got to be Googlified. Googlification of a trade or profession requires its practitioners be open and transparent. Are you Googlified? If you want to remain relevant, Jarvis says you’d better be. However, we would ask the question whether this maxim necessarily applies to all types of business.

No More Depth Thinking? Could Have Fooled Us!

Naturally, as TCs, we value our ability to communicate in an articulate way. If this means writing in long form, we appreciate having a format permitting that. Consequently, those still uninitiated into social media might resent being “forced” to fold a message into the limited space afforded by many Web applications (like micro-blogs) which might seem extreme.

Jarvis says that although it may appear that writing in short blog bursts, as opposed to lengthier articles, leads to rushed, haphazard, shallow communication, in fact, the opposite could be argued. Namely, an idea could be thought out and articulated over the span of multiple posts [even Tweets?], and take shape over the course of time. What’s more, these ideas percolate with input, challenge, and argument from many blog readers and consumers. Furthermore, ideas that don’t work, i.e. those not meriting response from the readership, get dropped. Thus, Jarvis argues that blogs provide a new and efficient means of both collaboration and peer review, which he claims “is the key product and skill of the Google age.”

The Internet might not make us more creative. But it does provide a platform enabling what we create to be “seen, heard, and used,” i.e. shared. In particular, the Internet enables every creator to “find a public, the [one] s/he merits.” What’s more, it levels the playing field of creativity. As Jarvis puts it, in the Google age, to “stand out, one must rise on worth—as defined by the public, rather than the priests, [where] the reward is attention.”

Us Worry?

What will coalesce in place of the institutions losing influence as a result of the Internet and Google? Or, as we’d put it, those failing to adapt and respond strategically to these forces. According to Jarvis, this applies not only to media organizations, businesses and individuals, but to governments and even religions (though there’s still some speculation as to how that would work).


Will we have anarchy or a new form of organization? The Internet, says Jarvis, is disaggregating the elements that have historically defined us humans. These definitions—liberal, conservative, libertarian—are breaking apart to form new expressions that are more nuanced. As a result, new loyalties are forming from the grassroots, replacing traditional allegiances.

Generation G

Advertising execs, public relations folk, and social media pundits like invoking Generation X (ambitious and family centered) and Generation Y (independent, expecting instant gratification) as supposedly well-understood demographic groups. In WWGD, Jarvis introduces us to Generation G, that is, the Google generation. Gen G has not only grown up in the computer age, but came of age by the time Google was already synonymous with Internet search. Beyond being characterized as independent, Gen G is possessed of a strong individualism, which could end up manifesting as empowerment [good], or as entitlement [bad].

Watch Gen G. Listen to Gen G. Understand how Gen G thinks, works, shops, [and we would add, reads]. Only thus can we have any hope of surviving, let alone thriving, over the coming decades.

Where Do We Take it Now?

Some critical reviews of WWGD urge that we disregard Jarvis’ prescription for Google-age success based on the assertion that Jarvis rambles on in an arrogant tone, doing little more than smugly dropping names and making scary generalizations. While we could agree that Jarvis presents himself as erudite and professorial, this hardly presents justification for rejecting what he prescribes, especially if his basic position is valid (and we believe it is).

What’s the upshot for TCs? We’re told that we need to not only innovate, but make innovation part of the culture where we work. What does that mean practically speaking? For one thing, we need to unlearn many of the practices that have taken us thus far in life and in our careers.

We need to Googlifiy ourselves. Googlification of our profession requires us to be open and transparent. While most of us are “out there” on a social network somewhere, many of us either aren’t ready to exploit the full potential of those networks, or worse, refuse (usually on “privacy” grounds) to participate. Concerning privacy, Vint Cerf, acclaimed as one of the fathers of the Internet, has written “There isn’t any privacy. Get over it.” Jarvis adds clarity to this statement by asserting that privacy is no longer the issue, control is. We do in fact have the right to control our personal information, whether it’s made public, and to whom. So decide upon a security policy that meets your needs, and get yourself out there.

There’s also the issue of intimacy. Participating in a social or business network does not mean laying it all bare for the world to see. Actually, showing us parts of your life to which we’d rather not be exposed would not win you the attention you should be seeking. But we do need to acclimate ourselves to what Leisa Reichelt calls “ambient intimacy.” This refers to the sense of closeness you have with folks as a result of social media; folks with whom you’d otherwise not have nearly as close a relationship, maybe even not know at all.

We should learn, Jarvis says, to think like kids, because once you’re thinking [too much] like an adult, you’re probably not innovating.

Special thank you to Jonny Gold for his input and thoughts.