Robert Desprez Communications

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

TECHNICAL WRITERS ARE RELUCTANT SELF-MARKETERS

June 21, 2011 by RDesprez 5 Comments

I don’t know how many times I’ve talked to tech­ni­cal writ­ers who’ve said to me that they dis­like self-marketing.

If you’re employ­ee and you don’t like mar­ket­ing your­self, it may mean you suf­fer from a lack of vis­i­bil­i­ty with­in your com­pa­ny. Peo­ple know your name but they may not under­stand what you do or how you add any val­ue to the orga­ni­za­tion. If you’re a con­tract writer and you dis­like mar­ket­ing, the results can be more serious—a track record that is marred by long peri­ods of unemployment.

Why do tech­ni­cal writ­ers dis­like mar­ket­ing so much? Here are a cou­ple of guesses:

  • Most tech­ni­cal writ­ers are intro­verts. By their very nature, tech­ni­cal writ­ers don’t like to stand in the lime­light or toot their own horns. They enjoy work­ing alone, not net­work­ing, and cer­tain­ly not pre­sent­ing a top­ic to others.
  • They haven’t learned about mar­ket­ing. Many writ­ers I’ve talked to often wrin­kle their noses when talk­ing about mar­ket­ing as if it’s a dirty word.

Mar­ket­ing, in my mind, is vital to the ongo­ing suc­cess of an orga­ni­za­tion. As a con­tract writer, I believe it’s impor­tant to remind clients and prospects about who I am and the ser­vices I offer, even when I’m work­ing on a long-term con­tract. If you don’t remind peo­ple of the ser­vices you provide—whether it’s an e‑mail, blog post, or upcom­ing pre­sen­ta­tion you’re sched­uled to deliver—people for­get about you. And if they for­get you, you won’t hear about upcom­ing jobs.

Some­times peo­ple dis­like some­thing because they don’t under­stand it. If you’re a con­tract tech­ni­cal writer strug­gling with lin­ing up con­tracts and feel that mar­ket­ing is not your forte, I’d rec­om­mend you read Duct Tape Mar­ket­ing by John Jantsch, which pro­vides an excel­lent overview of mar­ket­ing activ­i­ties for a small busi­ness. Who knows? You might start enjoy­ing mar­ket­ing after all.

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog Tagged With: career development, technical writers

COMPLACENCY AND TECHNICAL WRITERS

February 11, 2011 by RDesprez 4 Comments

I’ve seen it hap­pen many times. Col­leagues who chal­lenge them­selves in their careers and nab a desir­able job with a sought-after title. Maybe the job is a Tech­ni­cal Com­mu­ni­ca­tions Man­ag­er role. Per­haps it’s a Senior Tech­ni­cal Writer position.

After they set­tle into the new role and demon­strate suc­cess for some peri­od of time, they appear to stop learn­ing. It’s as if they’ve reached their goal and don’t want to push them­selves any­more. Here are two exam­ples I’ve witnessed:

  • The man­ag­er who just wants to write. They love writ­ing but they’re not that keen on tech­nol­o­gy and they avoid terms like DITA and XML, even though more and more jobs require these skills.
  • The tech­ni­cal writer who works for a large well-known com­pa­ny that is strug­gling finan­cial­ly. He knows the com­pa­ny is going through chal­leng­ing times but doesn’t both­er apply­ing for any jobs out­side of the firm. He feels secure and can’t be both­ered to be proac­tive. One day, senior man­age­ment decides to lay off almost every­one in the divi­sion, includ­ing the tech­ni­cal writer. He’s unem­ployed for six months because he is now com­pet­ing with all the oth­er writ­ers who were laid off. He almost exhausts his sav­ings in the process.

It’s not unique to tech­ni­cal writ­ers and man­agers. I know some­one who worked for years as a mar­ket­ing con­sul­tant. When social media became more and more preva­lent, he dis­missed it as a fad, when it actu­al­ly became a require­ment for a job. If you were an employ­er and you had to choose between an eager can­di­date who was well versed in RSS feeds, blogs, and viral mar­ket­ing and an expe­ri­enced but expen­sive mar­ket­ing per­son who was still mired in the 1990s, who would you choose?

In my opin­ion, all of these peo­ple became com­pla­cent. They stopped car­ing about learn­ing and improving.

Why do peo­ple do this? Do these exam­ples ring a bell? Why do you think that some peo­ple fall into this rut?

Filed Under: Career Development, Online Reading, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: career development, complacency, technical writers

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

WEB ANALYTICS FOR TECHNICAL COMMUNICATORS

February 26, 2010 by RDesprez Leave a Comment

Tech­ni­cal com­mu­ni­ca­tion depart­ments his­tor­i­cal­ly have had lit­tle idea how their deliv­er­ables were used, if at all.

More often than not, depart­ments assid­u­ous­ly worked to make sure that the con­tent was tech­ni­cal­ly cor­rect, that the deliv­er­ables adhered to the com­pa­ny style guide, and that the items were shipped before or on the agreed-upon deadlines.

After suc­cess­ful­ly ship­ping, mean­ing­ful feed­back was hard­ly a del­uge. More real­is­ti­cal­ly, it was a trickle—some anec­do­tal feed­back that a user liked it, or an e‑mail that the sales rep­re­sen­ta­tive thought it hit the mark. Talk about walk­ing through the fog.

Web ana­lyt­ics soft­ware changes that dynam­ic. By adding a few lines of code to an intranet site, a help sys­tem that is host­ed on a web serv­er, or a sup­port web site, you can quickly:

  • Dis­cern about how many peo­ple are view­ing a cer­tain web page (such as a trou­bleshoot­ing item) for a peri­od of time.
  • Dis­cov­er how long users spend on a web page.
  • Learn where the cus­tomer is phys­i­cal­ly locat­ed (that is, the coun­try they live in).
  • Under­stand the pop­u­lar­i­ty of dif­fer­ent deliv­er­ables, such as PDF files.

All of this data pro­vides tech­ni­cal com­mu­ni­ca­tors with insights into how con­tent is used, and ideas of where to direct your efforts.

Here’s one real-life exam­ple. My soft­ware team learned that users didn’t under­stand one facet of the soft­ware. Respond­ing to that need, we cre­at­ed the doc­u­ment, local­ized it into sev­en lan­guages, and mon­i­tored its pop­u­lar­i­ty when it was post­ed to our sup­port web site. Our users appeared to like it—using web ana­lyt­ics we could con­firm that it was one of the most accessed doc­u­ments for months.

We may not get to phys­i­cal­ly vis­it users as much as we’d like. But web ana­lyt­ics at least gives us some sem­blance of how doc­u­ments are used.

Filed Under: Career Development, Online Writing, Robert Desprez | Vancouver technical writer | Blog, Technology, Web 2.0 Tagged With: career development, technical writing, web analytics

  • « Previous Page
  • 1
  • 2
  • 3

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,150 239

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 ·
18h 1931387924311912959

Companies must make changes for training to be effective for younger workers /via @globeandmail

Image for twitter card

Companies must make changes for training to be effective for younger workers

Bottom line: for training to be effective today, especially for younger employees, it needs to be customized, relevant and timely

www.theglobeandmail.com

Reply on Twitter 1931387924311912959 Retweet on Twitter 1931387924311912959 0 Like on Twitter 1931387924311912959 0 Twitter 1931387924311912959
robert_desprez avatar; Robert Desprez @robert_desprez ·
26 May 1927021047175430324

How to throw a little luck into your career /via @globeandmail

Image for twitter card

How to throw a little luck into your career

What if you could create some of your own luck?

www.theglobeandmail.com

Reply on Twitter 1927021047175430324 Retweet on Twitter 1927021047175430324 0 Like on Twitter 1927021047175430324 0 Twitter 1927021047175430324
robert_desprez avatar; Robert Desprez @robert_desprez ·
20 May 1924848939888738806

Is AI helping workers and improving productivity or just creating more work? /via @globeandmail

Image for twitter card

Is AI helping workers and improving productivity or just creating more work?

To reap the full benefits of AI, companies must be more creative than using it to automate existing tasks, one expert says

www.theglobeandmail.com

Reply on Twitter 1924848939888738806 Retweet on Twitter 1924848939888738806 0 Like on Twitter 1924848939888738806 0 Twitter 1924848939888738806
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923413647243559161

Image for twitter card

I Regret My Tesla | The Walrus

I wanted to be good. Then the car company fell from grace

thewalrus.ca

Reply on Twitter 1923413647243559161 Retweet on Twitter 1923413647243559161 0 Like on Twitter 1923413647243559161 0 Twitter 1923413647243559161
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.