Robert Desprez Communications

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

WAYS TO USE TECHNOLOGY TO CONNECT WITH USERS

September 5, 2011 by RDesprez 1 Comment

Most tech­ni­cal writ­ers have lit­tle idea how their deliv­er­ables are used, if at all.

We strive to ensure that the con­tent is tech­ni­cal­ly cor­rect, that the deliv­er­ables adhere to the com­pa­ny style guide, and that the items ship before or on the agreed-upon deadlines.

After suc­cess­ful­ly ship­ping, mean­ing­ful user feed­back is hard­ly a del­uge, if there’s any­thing at all. More real­is­ti­cal­ly, it is a trickle—some anec­do­tal feed­back that a user liked some­thing we wrote, or an e‑mail that the sales rep­re­sen­ta­tive thought it hit the mark.

Web 2.0 makes it eas­i­er to con­nect to users. Any­one with an Inter­net con­nec­tion and a com­put­er can cre­ate a YouTube video, add some con­tent to a Wikipedia page, write a blog, and so on. For tech­ni­cal writ­ers, this means it’s easy for our users to add com­ments on our help top­ics or web pages.

Here are two rel­a­tive­ly simple—and free—ways you can use tech­nol­o­gy to con­nect with your users.

Feed­back Forms and Commenting
At http://wufoo.com/examples/, you can add many types of forms to a web page or help top­ic with­out hav­ing to code any­thing. Using an embed­ded Con­tact Form, your users do not have to leave the site and you do not have to dis­sem­i­nate an email address that could be a tar­get of spam mail.

Anoth­er site worth vis­it­ing is http://disqus.com, which enables your users to add com­ments to a web site or online help top­ic. Sim­i­lar to a blog, your users can respond to a help top­ic that you’ve writ­ten and you can mon­i­tor and respond to the feed­back by e‑mail using your com­put­er, iPhone, or Android phone. Dis­qus also enables users to click a but­ton when they like a top­ic or web page you’ve authored, with­out requir­ing them to add a comment.

If you’d pre­fer not to add HTML code to your online help or web pages, you can also use Adobe Robo­Help to enable com­ment­ing as you long as you use the company’s Adobe AIR out­put for­mat. To learn more about the details of this option, vis­it tech­ni­cal writer Sarah Maddox’s blog.

Filed Under: Online Collaboration, Robert Desprez | Vancouver technical writer | Blog Tagged With: collaboration, Documentation, technology, tools, user feedback

IS HELP 2.0 HYPED?

June 29, 2011 by RDesprez 2 Comments

There’s been a lot of dis­cus­sion about “Help 2.0” in which users will be able to eas­i­ly com­ment on the con­tent you’ve writ­ten in a help topic.

The Soci­ety for Tech­ni­cal Communication’s Inter­com mag­a­zine recent­ly pub­lished an arti­cle titled “Under­stand­ing the Help 2.0 Rev­o­lu­tion.” I have to admit that I thought the arti­cle con­tained some excit­ing ideas: for the first time tech­ni­cal writ­ers may have an online dia­log with our read­ers using tech­nolo­gies like web posts and commenting.

In the same vein, author and teacher Clay Shirky wrote a book called Cog­ni­tive Sur­plus. In it, he asserts that North Amer­i­cans are watch­ing less tele­vi­sion and are embrac­ing col­lab­o­ra­tive tech­nolo­gies like blogs and wikis. Col­lec­tive­ly, we can pool our efforts to achieve amaz­ing results. Just look at the colos­sal effort of web sites like Wikipedia.

But I think we have a long way to go. For all this talk of col­lab­o­ra­tion, usabil­i­ty guru Jakob Nielsen argues that only one per­cent of peo­ple con­tribute to a site, nine per­cent are inter­mit­tent con­trib­u­tors, and 90 per­cent just read the con­tent. So if Nielsen is right, most peo­ple are still being pas­sive. Doesn’t sound that dif­fer­ent to watch­ing television.

Here’s an excerpt from Nielsen’s web site:

“Blogs have even worse par­tic­i­pa­tion inequal­i­ty than is evi­dent in the 90–9‑1 rule that char­ac­ter­izes most online com­mu­ni­ties. With blogs, the rule is more like 95–5‑0.1. Inequal­i­ties are also found on Wikipedia, where more than 99% of users are lurk­ers. Accord­ing to Wikipedi­a’s “about” page, it has only 68,000 active con­trib­u­tors, which is 0.2% of the 32 mil­lion unique vis­i­tors it has in the U.S. alone.”

Grant­ed, Nielsen’s research is about five years old. Maybe more peo­ple are now con­tribut­ing? But I doubt it’s sig­nif­i­cant­ly more.

Here‘s the bot­tom line. If you’ve cre­at­ed a web site or help sys­tem that incor­po­rates Web 2.0 tech­nolo­gies like com­ment­ing, don’t be sur­prised if you ini­tial­ly receive a trick­le of respons­es from your read­ers. My bet is that tech­ni­cal writ­ers will need to reg­u­lar­ly pro­mote their help sys­tems or web sites to encour­age more read­ers to post their feed­back. If you want an online dia­log with cus­tomers, it‘s not just a mat­ter of “build it and they will come.”

Filed Under: Online Collaboration, Robert Desprez | Vancouver technical writer | Blog Tagged With: collaboration, Documentation, Help Authoring Tools, technology, tools, user feedback

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,147 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 ·
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
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923413050498957392

Image for twitter card

Brian Chesky Lost His Mind One Night—and Now He's Relaunching Airbnb as an Everything App

Airbnb's CEO is spending hundreds of millions to relaunch his travel company as an all-purpose service app. Fitness!...

www.wired.com

Reply on Twitter 1923413050498957392 Retweet on Twitter 1923413050498957392 0 Like on Twitter 1923413050498957392 0 Twitter 1923413050498957392
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 May 1923412665478627824

Toronto Centre MP Evan Solomon appointed Canada’s first AI minister /via @globeandmail

Image for twitter card

Toronto Centre MP Evan Solomon appointed Canada’s first AI minister

Experts say Solomon could face a host of challenges in his role, including how to increase AI adoption and comme...

www.theglobeandmail.com

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