Robert Desprez Communications

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

Online Conferences for Technical Writers in 2022

January 30, 2022 by RDesprez Leave a Comment

Here’s a list of inter­est­ing North Amer­i­can and vir­tu­al con­fer­ences. With the pan­dem­ic still with us, it seems that the num­ber of con­fer­ences has dwin­dled, com­pared to pre­vi­ous years.

Lava­con, Octo­ber 23 to 26, 2022, New Orleans, LA
http://lavacon.org

Mad­World Con­fer­ence, June 12 to 15, 2022, Austin, TX and online ver­sion
Mad­World

STC annu­al con­fer­ence, May 15 to 18, 2022, Rose­mont, IL
http://summit.stc.org/

Write the Docs, May 22 to 24, 2022, Port­land, OR
Write the Docs

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

Streamline your MadCap Flare Search Results

April 17, 2021 by RDesprez Leave a Comment

Tech­ni­cal writ­ers with large help projects may want to con­sid­er imple­ment­ing Mad­Cap Flare’s search fil­ter func­tion­al­i­ty to help users stream­line their search results.

By default, Flare cre­ates HTML5 files with­out search fil­ters. By tag­ging your con­tent with meta­da­ta and com­plet­ing some relat­ed steps, you can cre­ate help with fil­ters that you define. For exam­ple, when users search for a term, they can select the type of con­tent they want. The fol­low­ing screen cap­ture shows a user who typed Login in the search field and is look­ing for trou­bleshoot­ing content. 

Flare’s search engine will then only dis­play con­tent relat­ed to the Login search term that is also tagged as trou­bleshoot­ing material.

How to set up search filters

As Flare has already writ­ten doc­u­men­ta­tion on this fea­ture, I have includ­ed the main steps and linked to Flare’s help top­ics. The fol­low­ing steps assume you already have some famil­iar­i­ty with Flare. 

Note: If you click each of the links in the fol­low­ing steps, you will dis­cov­er that there are about 35 steps to per­form in mul­ti­ple and seem­ing­ly dis­parate areas of Flare’s inter­face. If you make a mis­take in any of steps, your out­putted help may not include search fil­ters. I think this is one of the fea­tures in Flare that could def­i­nite­ly be simplified—if I attempt­ed to recre­ate each of the steps and include screen cap­tures, I could eas­i­ly write the equiv­a­lent of 10 pages of content.

Here are the main steps:

  1. Add a fil­ter set to your project in the Project Orga­niz­er under the Advanced fold­er. For more infor­ma­tion, see https://help.madcapsoftware.com/flare2020r3/Content/Flare/Search/Search-Filter-Sets/Adding-Search-Filter-Sets-Projects.htm
  2. Add meta­da­ta or con­cepts to your top­ics in Flare. This step involves tag­ging all your top­ics into cat­e­gories. For exam­ple, if my Flare project con­tains trou­bleshoot­ing top­ics, I will need to tag each trou­bleshoot­ing top­ic with a “trou­bleshoot­ing” con­cept. The good news is that I found this step to be pret­ty quick. There are dif­fer­ent ways to tag your con­tent; I end­ed up using the “drag-and-drop method.” See https://help.madcapsoftware.com/flare2020r3/Content/Flare/Concepts/Inserting-Concepts1.htm
  3. Cre­ate a search fil­ter, which lets users nar­rows their search based on the con­cepts you’ve added to top­ics. For more infor­ma­tion, see https://help.madcapsoftware.com/flare2020r3/Content/Flare/Search/Search-Filter-Sets/Creating-Search-Filters.htm
  4. Add a search bar to an HTML5 skin. This step is just a quick check to make sure the search bar is con­fig­ured to dis­play in the head­er. See https://help.madcapsoftware.com/flare2020r3/Content/Flare/Search/Required-Activities/Including-Search-Bars.htm#HowtoEnabletheSearchBarinanHTML5Skin
  5. Asso­ciate a skin with a tar­get. This is also a quick step to make sure your edit­ed skin appears in the tar­get. See https://help.madcapsoftware.com/flare2020r3/Content/Flare/Skins/Process/Associating-Skins-Targets1.htm
  6. Asso­ciate a search fil­ter set with a tar­get. See https://help.madcapsoftware.com/flare2020r3/Content/Flare/Search/Search-Filter-Sets/Associating-Search-Filter-Set-Target.htm

Although there is some plan­ning and effort to imple­ment search fil­ters, most of these steps will only need to be per­formed once.

Filed Under: Help Authoring Tools, Professional Development, Robert Desprez | Vancouver technical writer | Blog, Training

Online Learning Resources for Technical Writers

April 12, 2020 by RDesprez Leave a Comment

Once a year, I com­pile a list of upcom­ing tech­ni­cal writ­ing con­fer­ences in North Amer­i­ca and pub­lish a blog post. With the coro­na virus affect­ing all aspects of our lives, take a look at the Soci­ety for Tech­ni­cal Communication’s online con­fer­ence in May and some online resources to investigate.

STC Virtual Conference (May 17 to 20, 2020)

https://summit.stc.org/

There are some addi­tion­al “in-per­son” tech­ni­cal writ­ing con­fer­ences sched­uled for lat­er in the sum­mer and fall. I expect that these events will be post­poned or re-imag­ined as vir­tu­al events.

MadCap’s webinars

https://www.madcapsoftware.com/resources/recorded-webinars.aspx#flare

Adobe’s webinars

https://meetus.adobeevents.com/technicalcommunication/

Lynda.com courses

In the region I live, the local library offers res­i­dents a free mem­ber­ship to Lynda.com. If you don’t already have a paid mem­ber­ship, you may want to check whether your library pro­vides com­pli­men­ta­ry access. Here is a sam­pling of some cours­es relat­ed to tech­ni­cal writing.

Acro­bat DC Essen­tial Training

GitHub

Work­ing Remotely

Learn­ing Confluence

Instruc­tion­al Design

Get­ting Start­ed in User Experience

List of Good Technical Writing Books

List of books

Podcast on Technical Writing Trends for 2020

Pod­cast

Other Online Resources

While not spe­cif­ic to tech­ni­cal writ­ing, here’s a list of pop­u­lar mas­sive open online cours­es (MOOCs),  online pro­grams with unlim­it­ed par­tic­i­pa­tion and open access via the Inter­net. The list includes a diverse selec­tion of cours­es on arti­fi­cial intel­li­gence, phi­los­o­phy, the chem­istry behind cook­ing, the future of sto­ry­telling, pro­gram­ming, and learn­ing how to learn.

I hope you find this list help­ful. Stay healthy!

Filed Under: Career Development, Professional Development, Robert Desprez | Vancouver technical writer | Blog, Technology, Training Tagged With: massive open online courses, MOOCs, online courses, technical writing, virtual conferences

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

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

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

Image for twitter card

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.