Robert Desprez Communications

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

FrameMaker 12 documentation disappoints

March 22, 2015 by RDesprez 1 Comment

As FrameMak­er is an author­ing tool made for tech­ni­cal writ­ers, you might think that its help would be exemplary—a show­case of the tool’s capa­bil­i­ties that would inspire oth­er writ­ers to per­form their best work.

Clear­ly, the Adobe tech­ni­cal com­mu­ni­ca­tion group does not share that vision. When I launched FrameMak­er’s help to search for clar­i­fi­ca­tion on its new fea­ture that enables authors to pub­lish to online help (with­out Robo­Help), I felt disappointed.

First, the image qual­i­ty of the screen cap­tures is so poor that I found myself squint­ing to deci­pher them. From the “Mul­ti­chan­nel pub­lish­ing” help top­ic, here are two exam­ples of pix­e­lat­ed graphics:

Publish_icon_croppedGenerate_Multiple_outputs_cropped

In addi­tion, I felt dis­ap­point­ed because the “Mul­ti­chan­nel pub­lish­ing” help top­ic is so long—it is 27 pages when copied to a Word file! A few suggestions:

  • Chunk the con­tent: With a sea of text and a hand­ful of pix­e­lat­ed graph­ics (some of which are mis­aligned), it is over­whelm­ing. I’d split the con­tent into sub-pro­ce­dures to make the con­tent eas­i­er to digest.
  • Reduce the text: Believe it or not, the “Mul­ti­chan­nel pub­lish­ing” help top­ic con­tains almost 7,000 words. When writ­ing con­tent that will be read online, aim to reduce the word count by 50 per­cent. That means if you write a doc­u­ment that is meant to be print­ed and it is 1,000 words, con­sid­er writ­ing 500 words for an online doc­u­ment. With­out a doubt, I’m sure that the con­tent could be more con­cise. For more infor­ma­tion about these guide­lines, see Ruth­less­ly edit when writ­ing for mobile.

I usu­al­ly don’t go out of my way to be crit­i­cal of oth­er tech­ni­cal doc­u­men­ta­tion. If you want to cre­ate online help that is not out­stand­ing, that’s your choice. But per­haps the Adobe writ­ers could at least strive for clear and concise?

Filed Under: Help Authoring Tools, Online Writing, Robert Desprez | Vancouver technical writer | Blog Tagged With: FrameMaker, Help Authoring Tools, online writing

List of upcoming
technical communications conferences

February 5, 2015 by RDesprez 6 Comments

Here’s a list of upcom­ing con­fer­ences this year in North America.

Intel­li­gent Con­tent Con­fer­ence, March 23–25, San Francisco
http://www.intelligentcontentconference.com/

Mad­World 2015 World­wide Learn­ing Con­fer­ence, April 12–14, San Diego
http://www.madcapsoftware.com/events/madworld/

Writ­er­sUA User Assis­tance Boot Camp, April 15–17, Seattle
http://west.writersua.com/

Con­tent Man­age­ment Strategies/DITA North Amer­i­ca, April 20–22, Chicago
http://www.cm-strategies.com/2015/index.htm

IA Sum­mit, April 22–26, Minneapolis
http://www.iasummit.org/

Write the Docs 2015, May 17–19, Portland
http://www.writethedocs.org/conf/na/2015/

STC annu­al con­fer­ence, June 21–24, Columbus
http://summit.stc.org/

Lava­con, Octo­ber 18–21, New Orleans
http://lavacon.org

How do you keep your skills up to date? Any oth­er North Amer­i­can con­fer­ences that I should add?

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog, Technology, Training Tagged With: career development, conferences, technical writing, training

The perils of ageism in high-tech

January 19, 2015 by RDesprez 4 Comments

Have you ever gone through a job inter­view on the phone that seems to have gone well and then it falls flat when the hir­ing team meets you in person?

What hap­pened? Per­haps you did­n’t sell your­self well? Were your salary expec­ta­tions too high? Or was the team most­ly in their twen­ties and did­n’t think you’d be a “good fit” because of your age?

I haven’t expe­ri­enced ageism first-hand but Sil­i­con Val­ley is infa­mous for its dis­crim­i­na­tion of old­er work­ers. In a New Repub­lic arti­cle called “The Bru­tal Ageism of Tech,” author Noam Scheiber writes: “Sil­i­con Val­ley has become one of the most ageist places in Amer­i­ca. Tech lumi­nar­ies who oth­er­wise pride them­selves on their ded­i­ca­tion to mer­i­toc­ra­cy don’t think twice about derid­ing the not-actu­al­ly-old. ‘Young peo­ple are just smarter,’ Face­book CEO Mark Zucker­berg told an audi­ence at Stan­ford back in 2007.”

Andrew Davis, a recruiter of tech­ni­cal writ­ers and train­ers, sees age-relat­ed dis­crim­i­na­tion first-hand and helps job can­di­dates resolve these issues. In a recent webi­nar, he said that hir­ing teams and man­agers may be con­cerned about hir­ing work­ers for the fol­low­ing reasons:

  • Cul­tur­al fit: Man­agers and teams want work­ers to share the same work styles.  “They (the hir­ing team) works long hours. They don’t have lives or bal­anced lives. And they often want you to drink the Kool-Aid,” said Davis, who runs Syn­er­gis­tech Com­mu­ni­ca­tions in California.
  • Health: Orga­ni­za­tions in the U.S. may wor­ry about the health costs for insur­ing an old­er work­er. In Cana­da, hir­ing man­agers and teams may be sim­i­lar­ly con­cerned about the health and the ener­gy lev­el of an old­er candidate.
  • Tol­er­ance for chaos: Some teams love the adren­a­line rush of not decid­ing on a giv­en path, whether it’s the name of a prod­uct, a tech­nol­o­gy to use, or a user inter­face to select. In con­trast, old­er tech­ni­cal writ­ers may not enjoy the pro­longed ambi­gu­i­ty. Some­times jus­ti­fi­ably, expe­ri­enced writ­ers may feel that the inde­ci­sion ham­pers their abil­i­ty to meet deadlines.
  • Flex­i­bil­i­ty: Mem­bers of start-ups enter­tain the cheap­er tools such as wikis and open source con­tent man­age­ment sys­tems. Old­er work­ers may bris­tle at the idea of using these tools when, in their view, there are supe­ri­or and well-estab­lished (but more expen­sive) tools avail­able.  In addi­tion, teams at start-ups may want a new hire to wear many hats, such as tech­ni­cal writer, mar­ket­ing writer, and e‑learner spe­cial­ist. Old­er work­ers may not embrace being a gen­er­al­ist. In my expe­ri­ence, find­ing a niche is a bet­ter career strategy.
  • Open seat­ing par­a­digm: If the orga­ni­za­tion uses an open-con­cept seat­ing mod­el, the team may see this as a way to increase spon­tane­ity and fos­ter com­mu­ni­ca­tion. For the old­er can­di­date, all this spon­tane­ity feels like end­less inter­rup­tions that thwarts one’s abil­i­ty to write.

Also, I would add to Davis’s list “com­pla­cen­cy.” I have known 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­ager role. Per­haps it’s a Senior Tech­ni­cal Writer posi­tion. 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. I wrote a blog entry about com­pla­cen­cy.

Techniques to land the job

Despite some of the per­ceived short­com­ings of being old­er, an expe­ri­enced work­er adds val­ue to an orga­ni­za­tion in a myr­i­ad of ways. Here are some qual­i­ties that Davis mentioned:

  • Effi­cien­cy and focus: Expe­ri­enced work­ers know what method­olo­gies and tech­niques work and when to apply them.
  • Pac­ing: Sea­soned work­ers know how to pace them­selves with­out burn­ing out.
  • Self-aware­ness: Vet­er­ans under­stand their strengths and weak­ness­es and when to seek help.
  • Clar­i­ty: Expe­ri­enced work­ers know when and how to set clear expectations.

If you are an old­er work­er and feel that ageism may be a fac­tor in the hir­ing deci­sion, Davis rec­om­mends that you put the needs of the hir­ing teams first, don’t lec­ture or bul­ly with expe­ri­ence, earn trust, make the hir­ing teams look good, and find ways to become indis­pens­able. A few years ago, I read mar­ket­ing guru Seth God­in’s book Linch­pin: Are You Indis­pens­able? Well worth the read.

Have you expe­ri­enced ageism? Were you able to over­come the hir­ing team’s objections?

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: ageism, career development, job searching, Silicon Valley, technical writers

Improve your training with practice and feedback

September 24, 2014 by RDesprez Leave a Comment

Have you ever attend­ed a course or train­ing ses­sion that missed its mark?

Most of the cours­es that I have tak­en haven’t met my expec­ta­tions for dif­fer­ent rea­sons. In uni­ver­si­ty, there was the pro­fes­sor who’d lec­ture for an hour, lulling stu­dents to sleep. There was the work­place train­er who focused on how the soft­ware worked but not the tasks that stu­dents (or learn­ers) required. There was the employ­ee who was threat­ened about shar­ing too much for fear of los­ing her job so she with­held knowl­edge, ren­der­ing the train­ing almost use­less. I could go on.

In my expe­ri­ence, senior man­age­ment holds the belief that any­one can train. But few peo­ple do it well.

Too often train­ing is just a “pletho­ra of regur­gi­tat­ed knowl­edge,” said Jim Tall­man, pres­i­dent of North Pacif­ic Train­ing & Per­for­mance Inc. Tall­man spoke at the Cana­da West Chap­ter of the Soci­ety for Tech­ni­cal Com­mu­ni­ca­tion for a pro­fes­sion­al devel­op­ment ses­sion on Sep­tem­ber 13th.

Train­ing that focus­es on rehash­ing knowl­edge doesn’t help learn­ers per­form their jobs bet­ter and pro­vides incon­sis­tent results, he said.  Some exam­ples of inef­fec­tive train­ing include:

  • The cur­ricu­lum fol­lows the­o­ry, not skills or tasks that one per­forms on the job.
  • Con­tent fol­lows course design, not a task analysis.
  • Exam­ples focus on sys­tem fea­tures, not work­place processes.
  • The course high­lights the knowl­edge of the sys­tem, not improved performance.
  • The instruc­tor nev­er stops talking.

A better way to train

An alter­na­tive method of train­ing focus­es on improv­ing the learn­ers’ skills. Some ele­ments of effec­tive training:

  • Task analy­sis dri­ves course design.
  • Cur­ricu­lum reflects the job.
  • Con­tent is prac­tice-based and learn­er paced.
  • Course results in improved job performance.

He said: “This is the pre­ferred way…that train­ing should be designed to give learn­ers what they need and clients their money’s worth. Instruc­tion is based on how learn­ers learn and not on how much the train­er can demo his or her prowess in the field.”

Train­ing should be ide­al­ly 30 per­cent pre­sen­ta­tion or lec­ture and 60 per­cent hands-on (such as exer­cis­es or activ­i­ties), said Tall­man. The final 10 per­cent of the course should be allo­cat­ed on feed­back so that learn­ers can improve. Most tra­di­tion­al train­ing is reversed with the instruc­tor talk­ing most of the time and learn­ers’ eyes glaz­ing over after 20 min­utes of lec­ture, he said.

In addi­tion, effec­tive train­ing should be also mean­ing­ful, mem­o­rable, moti­va­tion­al, and mea­sur­able, Tall­man said.

  • Mean­ing­ful: Train­ing should be rel­e­vant for learn­ers so they can per­form key tasks rel­e­vant to their jobs.
  • Mem­o­rable: Learn­ers need to remem­ber their train­ing after the course. Job aids, hand­outs, and quick ref­er­ence cards may be able to assist.
  • Moti­va­tion­al: Train­ing should moti­vate learn­ers in the class­room so that they want to apply the new skills.
  • Mea­sur­able: Effec­tive train­ing teach­es new skills that can be observed. “Good learn­ing events stress observ­able behav­iors, give learn­ers suf­fi­cient prac­tice over time, and pro­vide per­for­mance feedback.”

Not sur­pris­ing­ly, Tall­man’s train­ing focused on prac­tice and feed­back so that learn­ers could improve. This was an excel­lent presentation!

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog, Technology, Training Tagged With: career development, technical writing, technology, training

Managing risk in your career

May 19, 2014 by RDesprez Leave a Comment

Many Cana­di­ans are not risk tak­ers. We are a nation of home buy­ers (homes are per­ceived as safe and secure by many) and we grav­i­tate towards sta­ble jobs, ide­al­ly with full ben­e­fits and pensions.

In the book Start-up of You, LinkedIn co-founder and author Reid Hoff­man argues that overt­ly pur­su­ing safe­ty and secu­ri­ty in your career can leave you “…exposed to a huge blow-up in the future.”

Think of gov­ern­ment work­ers. They typ­i­cal­ly don’t take huge risks along the way in their careers. For their loy­al­ty, they receive incre­men­tal pay increas­es, good ben­e­fits, and a gen­er­ous pen­sion. For many peo­ple, this is utopia.

Com­pare these gov­ern­ment work­ers to real-estate agents, who need to hus­tle to find their work. Occa­sion­al­ly, they sell an expen­sive home and col­lect a lucra­tive com­mis­sion. The next month, how­ev­er, they may not sell any­thing. Their incomes are great some times, fol­lowed by lean periods.

Hoff­man writes: “He [the gov­ern­ment work­er] always eats well…until the day comes that gov­ern­ment pen­sions explode or aus­ter­i­ty mea­sures wipe out his depart­ment. Now he’s screwed. He will starve because, unlike the real estate agent, he has no idea how to deal with the downs…” A cen­tral theme of Hoff­man’s chap­ter on risk is that work­ers should take cal­cu­lat­ed risks in their careers to make them­selves more resilient when some­thing unex­pect­ed happens.

Title wave

Peo­ple don’t just per­ceive gov­ern­ment to be low risk. In the late 1990s, Nor­tel could do no wrong—it was seen as a great place to work and its CEO was her­ald­ed as a cap­i­tal­ist hero. At the time, employ­ees were envied. A few short years lat­er, after the dot-com bub­ble burst, Nor­tel laid off 60,000 employ­ees. In 2009, the com­pa­ny filed for bank­rupt­cy and now its pen­sion is in tat­ters. Long-term employ­ees must have been stunned.

Taking intelligent risks

If you lived on an African savan­nah in cen­turies past, avoid­ing risk—like com­ing face to face with a lion—made per­fect sense. Today, in the devel­oped world, most of us don’t need to wor­ry about get­ting eat­en alive. Hoff­man writes: “Over­es­ti­mat­ing risks and avoid­ing loss­es is a fine strat­e­gy for sur­viv­ing dan­ger­ous envi­ron­ments, but not for thriv­ing in a mod­ern career. When risks aren’t life-threat­en­ing, you have to over­come your brain’s dis­po­si­tion to avoid sur­viv­able risks.”

Hoff­man does not advo­cate tak­ing stu­pid risks. He argues that tak­ing risks makes sense when there’s a promise of a reward.

Here are some exam­ples of tak­ing risks in your career:

Risk Pos­si­ble reward
Work­ing on contract. Earn more income.
Improve the diver­si­ty of your work.
Increase your network.
Mov­ing to anoth­er country. Immerse your­self in anoth­er culture.
Learn anoth­er language.
Increase your net­work abroad.
Learn­ing on the job, even if it for less money. Learn new tech­nolo­gies or skills could that open doors down the road.
Return­ing to school. Learn new skills and knowledge.
Increase your net­work with peers.

Oth­er than con­tract­ing, I some­times take a cal­cu­lat­ed risk by pre­sent­ing a top­ic at an upcom­ing tech­ni­cal writ­ing con­fer­ence. How is that a risk? Because I don’t always know every­thing about the sub­ject. In some cas­es, I’ve just scratched the sur­face of a top­ic and I need to research the con­tent, cre­ate and prac­tice the pre­sen­ta­tion, and deliv­er it to a crowd of peers in a rel­a­tive­ly short time. This forces me to learn a lot about a sub­ject quick­ly and there is always a pos­si­bil­i­ty of fail­ure. Of course, there are ben­e­fits too. I learn new skills and I present my new knowl­edge to a crowd, which increas­es my vis­i­bil­i­ty. I also can use that research to present at oth­er events and writes arti­cles for mag­a­zines, such as the Soci­ety for Tech­ni­cal Com­mu­ni­ca­tion’s Inter­com magazine.

In the short term, avoid­ing risk seems like a good path for­ward. But over the long-haul, Hoff­man writes “low volatil­i­ty leads to increased vul­ner­a­bil­i­ty because it ren­ders the sys­tem [and your career] less resilient to unthink­able exter­nal shocks…If you don’t find risk, risk will find you.”

Do you agree? If so, how do you take risks at your work?

Filed Under: Career Development, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: careers, managing risk, technology

  • « Previous Page
  • 1
  • …
  • 6
  • 7
  • 8
  • 9
  • 10
  • …
  • 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.