Robert Desprez Communications

  • My Services
  • My Blog
  • About Me
  • Contact Me

WEB 2.0 and TECHNICAL COMMUNICATORS

December 9, 2010 by RDesprez 5 Comments

Web 2.0 has rev­o­lu­tion­ized the way soci­ety uses the Inter­net. Whether it’s Wikipedia, YouTube, Twit­ter, or LinkedIn, we’ve moved from pas­sive read­ers to active contributors.

Giv­en this fun­da­men­tal change, why is it that most tech­ni­cal com­mu­ni­ca­tors are oper­at­ing as if Web 2.0 nev­er occurred? Based on what I’ve seen, most writ­ers haven’t embraced the col­lab­o­ra­tive mod­el that is com­mon­place with Web 2.0. Why? Here are a few guesses:

  • Some of the web sites are rel­a­tive­ly new. Twit­ter, for instance, has real­ly only tak­en off in the last 18 months. Most writ­ers haven’t fig­ured out whether to use sites like this and how to use them in their jobs.
  • Our tools haven’t ful­ly embraced Web 2.0. The tools that tech­ni­cal writ­ers use don’t ful­ly take advan­tage of Web 2.0. RoboHelp’s new­er Help for­mat, AIR Help, does per­mit users to com­ment on a giv­en top­ic but it doesn’t allow writ­ers to mod­er­ate those com­ments. To me, this is “Web 2.0 lite.”
  • Slow accep­tance of social media by tech­ni­cal com­mu­ni­ca­tion depart­ments. Mar­ket­ing peo­ple have ful­ly embraced sites like Face­book, LinkedIn, and Twit­ter. But from what I’ve seen, tech­ni­cal com­mu­ni­ca­tion depart­ments appear to be tak­ing a “wait and see” approach when it comes to lever­ag­ing these technologies.

Of course, there are orga­ni­za­tions that have tak­en full advan­tage of social media—more on this lat­er. But I believe these orga­ni­za­tions are the excep­tion rather than the norm.

Too bad. I believe that incor­po­rat­ing Web 2.0 tech­nolo­gies into tech­ni­cal doc­u­men­ta­tion could make our con­tent bet­ter, fos­ter more dia­log with our cus­tomers, and change—and improve—our careers.

Filed Under: Career Development, Online Reading, Robert Desprez | Vancouver technical writer | Blog, Technology, Web 2.0 Tagged With: social media, technical writing, Web 2.0

E‑MAIL’S DARK SIDE

November 19, 2010 by RDesprez 2 Comments

Most of us are total­ly hooked on e‑mail. We couldn’t imag­ine life with­out it. If my Out­look isn’t flash­ing a pre­view of my lat­est e‑mail, my iPhone is buzzing.

I came across a real­ly inter­est­ing arti­cle on e‑mail titled, “E‑mail’s Dark Side: 10 Psy­chol­o­gy Stud­ies.” Some inter­est­ing find­ings include:

You check more than you think. Accord­ing to this study, par­tic­i­pants claim to check their e‑mails, on aver­age, once an hour. “How­ev­er, when the researchers spied on them, it turned out they checked their e‑mail every five min­utes.” I don’t know that I’m check­ing it that fre­quent­ly but it’s cer­tain­ly more than once an hour.

E‑mail eats a quar­ter of the work­ing day. Researchers found that “this is because peo­ple are not just using e‑mail to com­mu­ni­cate, they are also using it as a way of track­ing tasks.” I guess I fall in that camp: Every day I cre­ate a task list for myself in Out­look and check it through­out the day to mon­i­tor if I’m on track.

It takes 64 sec­onds to recov­er from an e‑mail. Par­tic­i­pants took about a minute to recov­er their train of thought after an interruption.

Low rap­port when using e‑mail. My boss com­plains that no one uses the phone any­more. She has a point. Researchers found that “even a sin­gle tele­phone call can cre­ate enough good feel­ing between the par­ties to bridge the rap­port gap.”

Here’s one of my pet peeves—delivering sen­si­tive news by e‑mail. Occa­sion­al­ly, a col­league decides to deliv­er unpleas­ant news that could be upset­ting using e‑mail. To make mat­ters worse, they “cc” a bunch of peo­ple on the e‑mail. Is it too much to ask to deliv­er the infor­ma­tion in per­son in a some­what sen­si­tive way? On a relat­ed note, one of the stud­ies notes that “peo­ple tend to be more neg­a­tive in e‑mail.”

Check out the study (exter­nal link).

Filed Under: Online Reading, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: disadvantages, distractions, downsides of e-mail

WEB ANALYTICS FOR TECHNICAL COMMUNICATORS

October 19, 2010 by RDesprez Leave a Comment

On Tues­day, Nov. 16th, I’m speak­ing at the Soci­ety for Tech­ni­cal Com­mu­ni­ca­tion West Coast chap­ter on “Web Ana­lyt­ics for Tech­ni­cal Communicators.”

Details of my talk
As tech­ni­cal com­mu­ni­ca­tors, we’re all in the busi­ness of com­mu­ni­ca­tion. We per­form research, we ask ques­tions about the audi­ence, we draft out­lines, write and edit con­tent, and ulti­mate­ly we dis­trib­ute it.

But what’s often miss­ing is the feed­back from our users. More often than not, we don’t have a clear sense of how many peo­ple are read­ing our con­tent, what con­tent is well used, or downloaded.
Web ana­lyt­ics soft­ware can help. With free tools like Google Ana­lyt­ics, one can quick­ly dis­cov­er the most fre­quent­ly accessed doc­u­ments or web pages, where users are locat­ed (i.e. what coun­try they live in), how long they spend review­ing web pages, the num­ber of unique vis­i­tors to a sup­port site or intranet, or even which online help top­ics are viewed if your help is host­ed on a web server.

What are the ben­e­fits to attending?
Web ana­lyt­ics is free, rel­a­tive­ly easy to set up, and pro­vides insights into how staff and exter­nal cus­tomers are find­ing your site, how they explored it, and how you can enhance the user experience.

When
Tues­day, Novem­ber 16, 2010
6:30 p.m. to 7:00 p.m. for social­iz­ing and appetizers
7:00 to 9:00 p.m. for the meeting

Where
Down­town YWCA Fit­ness Build­ing, 535 Horn­by St., Van­cou­ver, BC

 

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog, Social Media, Technology Tagged With: metrics, technical writing, web analytics

IS THERE A SHORTAGE OF IT WORKERS LOOMING?

September 15, 2010 by RDesprez Leave a Comment

Will the glob­al econ­o­my con­tin­ue to recov­er or will eco­nom­ic growth sput­ter, throw­ing coun­tries around the world into anoth­er reces­sion? No one knows for sure.

On the local front, yesterday’s Van­cou­ver Sun cit­ed a RBC Eco­nom­ics report that BC’s econ­o­my is pre­dict­ed to grow 3.3% this year and 3.1% next year.

If these fore­casts hold true, BC’s high-tech indus­try may face anoth­er short­age of staff. A lit­tle hard to believe, I know. But accord­ing to a BC Tech­nol­o­gy Indus­try Asso­ci­a­tion (BCTIA) report on labour trends released ear­li­er this year, high-tech com­pa­nies may face a short­age of work­ers again, sim­i­lar to the sit­u­a­tion we expe­ri­enced in 2007 and 2008.

One inter­est­ing quote from the report: “Despite the opti­mistic head­count pro­jec­tions pro­vid­ed by many respon­dents [that is, HR man­agers and senior man­age­ment of high-tech com­pa­nies in this province], the pro­jec­tion of the tal­ent crunch re-emerg­ing in late 2010 or ear­ly 2011 is a sur­prise to many respondents.”

The Labour Trends in the BC Tech­nol­o­gy Sec­tor report (PDF) is avail­able on the BCTIA’s web site.

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: high-tech workers, IT employment, shortage of workers

DRAWING MORE ON THE RIGHT-SIDE OF THE BRAIN

July 24, 2010 by RDesprez 3 Comments

If author Daniel Pink is right, tech­ni­cal writ­ers’ jobs may be chang­ing again.

Pink, who wrote A Whole New Mind, con­tends that the devel­oped world is enter­ing a new era—the so-called con­cep­tu­al age—during which right-brained skills, such as design and sto­ry­telling, will become far more cru­cial than tra­di­tion­al­ly left-brained skills such as account­ing and com­put­er pro­gram­ming. He cites three trends:

  • Automa­tion: Com­put­ers are increas­ing­ly more pow­er­ful (no big sur­prise to any­one who has heard of Moore’s law). As they become pow­er­ful, soft­ware can replace some of the sequen­tial, log­i­cal work for­mer­ly per­formed by our left brains. One sim­ple exam­ple: Instead of hir­ing an accoun­tant to review your tax­es, you can buy an off-the-shelf soft­ware pro­gram that will cal­cu­late your tax­es and grant you a refund for $19.
  • Asia: Asian coun­tries are brim­ming with ambi­tious, edu­cat­ed peo­ple who can often take on the jobs for­mer­ly done by West­ern­ers. Any­one who has worked in IT in the last 10 years will have noticed that soft­ware devel­op­ment jobs some­times dis­ap­pear in devel­oped coun­tries, only to be replaced by staff in an Asian coun­try, usu­al­ly because of the cost savings.
  • Abun­dance: Con­sumers have more choice than ever before. Most mid­dle-class cit­i­zens have more mate­r­i­al wealth than any gen­er­a­tion in his­to­ry. With all these choic­es at our dis­pos­al, many con­sumers can now buy well designed, lux­u­ry items that were once only avail­able to wealthy con­sumers. For exam­ple, many con­sumers won’t sim­ply set­tle for a util­i­tar­i­an toast­er that was on the mar­ket in the 1970s. Con­sumers now want a stain­less steel, ergonom­i­cal­ly designed appli­ance that can toast up to six slices of their favorite bread, and make a state­ment while resid­ing on a gran­ite kitchen countertop.

In short, some of the high­ly ana­lyt­i­cal jobs are becom­ing com­modi­ties that can be per­formed by a com­put­er or an inex­pen­sive work­er in Asia. Pink con­tends that devel­op­ing right-brain skills may help dif­fer­en­ti­ate you and keep you more employ­able. He iden­ti­fies six right-brain-asso­ci­at­ed aptitudes:

a) Sym­pho­ny: Adding inven­tion and big pic­ture thinking
b) Mean­ing: The pur­pose is the jour­ney, give mean­ing to life.
c) Design: Mov­ing beyond func­tion to engage the senses.
d) Sto­ry: Nar­ra­tive added to prod­ucts and ser­vices, not just argument.
e) Empa­thy: Going beyond log­ic and engag­ing emotion.
f) Play: Bring­ing humor and light-heart­ed­ness to busi­ness and products.

As tech­ni­cal writ­ers, I believe many of us already incor­po­rate some of these apti­tudes into our work.

Design
Many of us already mar­ry good writ­ing with design to make con­tent more acces­si­ble and eas­i­er to under­stand. When you mar­ry the two skills, tech­ni­cal doc­u­men­ta­tion may actu­al­ly be enjoy­able to read. I per­son­al­ly think Apple’s tech­ni­cal doc­u­men­ta­tion is use­ful and—dare I say it—beautiful.

In con­trast, there are many exam­ples of doc­u­men­ta­tion that are ter­ri­bly writ­ten and almost impos­si­ble to deci­pher. Pink argues that con­sumers are often will­ing to spend more on good design. Increas­ing­ly, con­sumers want some­thing that makes a state­ment. As proof, see the toast­er exam­ple I mentioned.

Sto­ry­telling
Pink argues that to make your mes­sage mem­o­rable and com­pelling, we must incor­po­rate the tech­niques of good sto­ry­telling. I per­son­al­ly don’t aspire to make my online help mir­ror a Hol­ly­wood script but I do think we could improve the way we deliv­er con­cep­tu­al infor­ma­tion. For exam­ple, we can incor­po­rate metaphors and add more visu­als to dri­ve home our message.

As tech­ni­cal writ­ers, we’re not immune to off-shoring. In Van­cou­ver (where I live), I’ve seen a num­ber of com­pa­nies try to off-shore tech­ni­cal doc­u­men­ta­tion. Employ­ing and mas­ter­ing right-brain activ­i­ties may help us stand out and even stave off job losses.

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: career development, daniel pink, technical writing, whole new mind

  • « Previous Page
  • 1
  • …
  • 16
  • 17
  • 18
  • 19
  • Next Page »

About Robert Desprez

I have worked as a Vancouver technical writer for more than 20 years, working at some of British Columbia's largest high-tech firms. I have served in leadership positions for the Society for Technical Communication and have worked as a writing instructor at Vancouver's Simon Fraser University.

Robert Desprez Follow 1,144 237

Vancouver Technical Writer. Former Instructor at Simon Fraser University. Dog Lover. Coffee Drinker. Tennis and Piano Player.

robert_desprez
robert_desprez avatar; Robert Desprez @robert_desprez ·
2 May 1918126029463536113

This productivity poison is exhausting you /via @globeandmail

This productivity poison is exhausting you

Constantly shifting your attention undermines what is your super power in most knowledge jobs. How you anticipate an...

www.theglobeandmail.com

Reply on Twitter 1918126029463536113 Retweet on Twitter 1918126029463536113 0 Like on Twitter 1918126029463536113 0 Twitter 1918126029463536113
robert_desprez avatar; Robert Desprez @robert_desprez ·
24 Apr 1915491435350253736

Google forcing some remote workers to come back 3 days a week or lose their jobs

Image for twitter card

Google forcing some remote workers to come back 3 days a week or lose their jobs

Several units within Google have told remote staffers that their roles may be at risk if they don't start showin...

cnb.cx

Reply on Twitter 1915491435350253736 Retweet on Twitter 1915491435350253736 0 Like on Twitter 1915491435350253736 0 Twitter 1915491435350253736
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 Apr 1912364221582758283

Image for twitter card

As Canadians cancel trips due to Trump, the U.S. tourism industry could lose billions

The Trump administration's attacks on its northern neighbor have been met with confusion and anger by some Canadians...

www.npr.org

Reply on Twitter 1912364221582758283 Retweet on Twitter 1912364221582758283 0 Like on Twitter 1912364221582758283 0 Twitter 1912364221582758283
robert_desprez avatar; Robert Desprez @robert_desprez ·
13 Apr 1911507080504303659

Image for twitter card

How to awaken Canada’s sleeping economic giant

Recent interviews with industry leaders and experts point toward 10 areas where actionable strategies are needed – ...

www.theglobeandmail.com

Reply on Twitter 1911507080504303659 Retweet on Twitter 1911507080504303659 0 Like on Twitter 1911507080504303659 0 Twitter 1911507080504303659
Load More

Recent Blog Posts

  • ChatGPT: The AI-Powered Proofreader
  • Four Ways Confluence Could Be Better
  • First impressions of MadCap’s purchase of IXIASOFT
  • Online Conferences for Technical Writers in 2023

About Me

Robert Desprez I have worked as a Vancouver technical writer for more than 20 years, working at Kodak, Boeing, Teck Resources, and FortisBC. In addition, I have worked as a writing instructor at Simon Fraser University in Vancouver.

Contact Me

Robert Desprez Com­mu­ni­ca­tions Inc.
North Van­cou­ver, British Columbia
Canada
Phone: 604–836-4290

  • Email
  • LinkedIn
  • Twitter

Copyright © 2025  · Robert Desprez Communications Inc.