Robert Desprez Communications

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

Ruthlessly edit when writing for mobile

November 27, 2011 by RDesprez 1 Comment

Imag­ine you have a den­tal appoint­ment and you arrive ear­ly. To kill the time, you might skim a copy of Newsweek that’s sit­ting in the wait­ing room. Or, if you are like mil­lions of peo­ple with a smart­phone, you might start perus­ing your e‑mail, surf­ing the Inter­net, or see­ing what’s new on Facebook.

Usabil­i­ty guru Jakob Nielsen com­plet­ed research that shows con­sumers are using mobile phones as time killers, per­fect for when you have five min­utes to spare. The same study also showed that peo­ple are impa­tient with any­thing that’s per­ceived as “ver­bosi­ty.”

In a typ­i­cal news­pa­per arti­cle, it’s not uncom­mon for a reporter to inter­view two to four sources when writ­ing about a nat­ur­al dis­as­ter, such as a hur­ri­cane. When con­sumers are read­ing the hur­ri­cane sto­ry on a mobile phone, they per­ceive those extra view­points as extraneous.

What does all this mean for tech­ni­cal writ­ers? If you’re writ­ing any con­tent that will be appear on a mobile phone, con­sumers want writ­ers to get to the point quickly.

It seems that peo­ple want less and less con­tent. Years ago, Nielsen rec­om­mend­ed that if you write 500 words for a print­ed doc­u­ment, prune that same mes­sage to 250 words when it’s read online. This lat­est study seems to sug­gest that we should be even more ruth­less when it comes to sum­ma­riz­ing our main messages.

It’s not sur­pris­ing that peo­ple want key mes­sages, not lengthy, nuanced expo­si­tion. Many North Amer­i­cans are feel­ing inun­dat­ed with infor­ma­tion, suf­fer­ing from “infobe­si­ty” (see my ear­li­er arti­cle about the top­ic). Many North Amer­i­cans also strug­gle with literacy—Canada has an illit­er­ate and semi­lit­er­ate pop­u­la­tion esti­mat­ed at 42 per­cent of the whole, a pro­por­tion that mir­rors that of the U.S. We’re also dis­tract­ed. It’s not uncom­mon to be “spend­ing time” with some­one when they’re furtive­ly star­ing down at their iPhone or Blackberry.

Like it or loathe it, more and more peo­ple are using smart­phones to get their infor­ma­tion. If you’re writ­ing online assis­tance for mobile users, you need to sum­ma­rize your mes­sages down to bite-sized chunks. Joe Welinske, the pres­i­dent of Writ­er­sUA, recent­ly wrote a series of webi­na­rs about mobile user assis­tance. In his book Devel­op­ing User Assis­tance For Mobile Apps, Welinske writes, “The sin­gle most impor­tant thing I have learned in my work with mobile apps is that bring­ing over Help designs from desk­top appli­ca­tions is a real­ly bad idea.”

So when you’re author­ing con­tent for a mobile envi­ron­ment, be ruth­less with your edit­ing. Imag­ine you are writ­ing for Twitter.

Here’s the full arti­cle about Nielsen’s research.

Filed Under: Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog Tagged With: mobile, online writing, smartphones

Users struggle with comprehension using mobile phones

October 29, 2011 by RDesprez 1 Comment

Con­sumers love their smart phones but research com­plet­ed this ear­li­er this year showed that com­pre­hen­sion lev­els for “com­pli­cat­ed” web con­tent were 48 per­cent of desk­top scores.

The study per­formed by R.I. Singh from the Uni­ver­si­ty of Alber­ta found that read­ers strug­gled with read­ing the pri­va­cy poli­cies of 10 pop­u­lar web sites—including Google’s and Microsoft’s—and found that the con­tent was too com­pli­cat­ed. I’m not sur­prised. Last time I skimmed a pri­va­cy pol­i­cy (in fact, I try to avoid read­ing them) it seemed that it was writ­ten by a squad of lawyers. Facebook’s pri­va­cy pol­i­cy was a mind-numb­ing 5,789 words!

The study found that com­pre­hen­sion lev­els were low­er pri­mar­i­ly because of the mobile phone’s small­er size. Users can see less at any giv­en moment and they some­times must scroll around a page, which is distracting.

Usabil­i­ty guru Jakob Nielsen’s arti­cle also states that it’s chal­leng­ing to use mobile phones for the fol­low­ing reasons:
* Slug­gish downloads.
* No phys­i­cal key­board for data entry. Writ­ing a short e‑mail or text is tol­er­a­ble on an iPhone. A longer doc­u­ment quick­ly becomes tedious.
* No mouse for selection.
* Web sites are still fre­quent­ly designed for desk­top and lap­top use.

It seems that once con­sumers buy a smart phone, they love it. Peo­ple often pro­claim that they can’t believe they lived with­out one. But for all the con­ve­nience and the abil­i­ty to com­mu­ni­cate almost any­where, it seems that we have a long way to go to make web con­tent easy to under­stand on mobile phones.

Tech­ni­cal writ­ers are ide­al­ly suit­ed to help ensure that con­tent is opti­mized for mobile use.

Here’s Nielsen’s full article.

Filed Under: Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog Tagged With: mobile, Online Reading, smartphones

GOOD PRACTICES FOR CREATING ONLINE HELP FOR MOBILE DEVICES

May 21, 2011 by RDesprez 8 Comments

I believe that tech­ni­cal writ­ers will need to think more and more about cre­at­ing online help for mobile devices as smart­phone sales sky­rock­et. Accord­ing to the Pew Research ser­vice, mobile devices will be the pri­ma­ry con­nec­tion tool to the Inter­net for most peo­ple by 2020.

With that in mind, I’ve start­ed read­ing more about cre­at­ing user assis­tance for mobile appli­ca­tions. Joe Welinske, the pres­i­dent of Writ­er­sUA, recent­ly wrote a series of webi­na­rs about mobile user assis­tance. I pur­chased the first webi­nar titled “UA in Mobile Plat­forms.” In it Welinske writes, “The sin­gle most impor­tant thing I have learned in my work with mobile apps is that bring­ing over Help designs from desk­top appli­ca­tions is a real­ly bad idea.”

So what are some good prac­tices for cre­at­ing help on mobile appli­ca­tions? As I am just learn­ing about the sub­ject myself, here are some rec­om­men­da­tions that I’ve gleaned. One real­ly good arti­cle on the sub­ject is “A User-Cen­tered Approach to Web Design For Mobile Devices” by Lyn­don Cere­jo. Here are some of Cerejo’s and Welinske’s rec­om­men­da­tions that can be applied to help:

Design for a small screen size

Unfor­tu­nate­ly, there is not one stan­dard screen size (this reminds me of the brows­er wars from years ago). To com­pli­cate mat­ters, some phones can change ori­en­ta­tion and users expect the web site to resize accordingly.

Simplify navigation

  • Reduce the num­ber of cat­e­gories and lev­els of nav­i­ga­tion, and rearrange con­tent based on pri­or­i­ty, pre­sent­ing the most impor­tant cat­e­gories first.
  • Use clear, con­cise and con­sis­tent labels for nav­i­ga­tion across the site.
  • When design­ing for touch, make sure the tap size (width or height) for the nav­i­ga­tion item is at least 30 pixels.
  • Bread­crumbs are usu­al­ly not used on mobile sites since nav­i­ga­tion is not usu­al­ly so deep that users need a trail back.
  • Make links obvi­ous, and pro­vide clear and imme­di­ate visu­al feed­back to show the select­ed link.
  • Be suc­cinct because of the small screen size.
  • Use short and descrip­tive titles for your pages.
  • If you must include scrolling, scroll in only one direc­tion. Most mobile sites scroll vertically.

Design for intermittent connectivity

Cell phone com­pa­nies are offer­ing faster net­works but it doesn’t mean the ser­vice is always avail­able. And not all users have unlim­it­ed data plans. So make sure that pages can be loaded quick­ly on a mobile device, and that images are rel­a­tive­ly small.

Search and indexes

Welinske believes index­ing and search tech­niques are of less use in mobile appli­ca­tions. “If a user needs to search for Help con­tent, then the user assis­tance is far too large.”

Design for a distracted user

Cere­jo argues that you can­not con­trol where cus­tomers will use the phone or even how it will be used. Here’s a quote from his arti­cle: “Pic­ture a mobile user try­ing to find direc­tions using a tiny phone with inter­mit­tent con­nec­tiv­i­ty, while strap hang­ing and sway­ing in a sub­way train with sub-opti­mal light­ing con­di­tions, deaf­ened by the screech­ing of wheels on tracks — that gives you some con­text of use. Sim­ply put, con­text is about the envi­ron­ment and con­di­tions of usage, includ­ing dis­trac­tions, mul­ti­task­ing, motion, light­ing con­di­tions and poor connectivity.”

Summary

In the next decade, most peo­ple will be using their cell phones to con­nect to the Inter­net. If this pre­dic­tion holds true, tech­ni­cal writ­ers will need to mas­ter deliv­er­ing help on smart­phones too. It will be an excit­ing and chal­leng­ing ride.

Filed Under: Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog Tagged With: best practices, mobile, smartphones, writing

AMAZING TED TALK HIGHLIGHTS THE FUTURE OF DIGITAL BOOKS

May 19, 2011 by RDesprez 1 Comment

In a recent blog post, I wrote some of my thoughts on how I think tech­ni­cal doc­u­men­ta­tion may change in the next 10 years. Based on the num­ber of com­ments post­ed, it seemed to gen­er­ate a lot of interest.

On a relat­ed note, I recent­ly vis­it­ed www.mytechcomm.org for the first time. One of the dis­cus­sion top­ics includ­ed a link to an online video that’s avail­able on the TED con­fer­ence web site. In the video, soft­ware devel­op­er Mike Matas presents the first full-length inter­ac­tive book for the iPad.

In the dis­cus­sion group, some tech­ni­cal writ­ers argued that this could be the future of tech­ni­cal doc­u­men­ta­tion. In my opin­ion, I could see some of these tech­nolo­gies being employed. But I’d also haz­ard a guess that cre­at­ing these inter­ac­tive graph­ics is chal­leng­ing and prob­a­bly very time con­sum­ing. What do you think? Here’s the web site: http://www.ted.com/talks/mike_matas.html

Filed Under: Online Reading, Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: interactive books, iPad

HOW WILL TECHNICAL WRITING CHANGE IN THE NEXT 10 YEARS

April 23, 2011 by RDesprez 12 Comments

How has tech­ni­cal writ­ing changed in the last 10 years? And how will it be dif­fer­ent in the com­ing years? I start­ed to think about these ques­tions when an old friend asked my opin­ion about how the tools and deliv­er­ables have changed since the late 1990s. She was work­ing as a tech­ni­cal writ­ing man­ag­er back then and is now con­sid­er­ing re-enter­ing the workforce.

I see two notable changes from 10 years ago:

XML author­ing. Of course, one of the main changes in the last 10 years is the wide­spread use of XML when author­ing tech­ni­cal doc­u­ments. Two years ago, Scrip­to­ri­um Pub­lish­ing (http://www.scriptorium.com ) asked more than 600 tech­ni­cal writ­ers whether they write in XML. A major­i­ty of respon­dents were either already writ­ing in XML, imple­ment­ing it, plan­ning to use it, or were at least con­sid­er­ing it. Only 16 per­cent of those sur­veyed didn’t plan to imple­ment it. XML author­ing is not a fad. It’s here to stay.

Improved tools. I start­ed using FrameMak­er 6.0 in the late 1990s. Adobe just released ver­sion 10 in Jan­u­ary. Thank­ful­ly, author­ing tech­ni­cal doc­u­ments has improved sig­nif­i­cant­ly. If you dis­trib­ute PDF doc­u­ments to sub­ject mat­ter experts who make edits in the PDFs, we can now import those edits back into the source files. No more tedious edit­ing. FrameMak­er and Robo­Help can sin­gle source. You can ask sub­ject mat­ter experts to review your files via “the cloud.”

How will tech­ni­cal writ­ing change again in the next 10 years? Here are some edu­cat­ed guesses:

We’ll all be prepar­ing our online help for mobile devices. Smart­phones and tablets are expect­ed to start out­selling com­put­ers in the near future. More and more peo­ple will be using these devices to work and will need tech­ni­cal assis­tance. I expect this is the next “big thing” for us.

Cloud com­put­ing may change how we per­form our jobs. Increas­ing­ly, we may be stor­ing our source files in the cloud, dis­trib­ut­ing tech­ni­cal drafts using the cloud, and even author­ing con­tent using cloud-based soft­ware. See my relat­ed post about cloud com­put­ing.

Social media will change how we com­mu­ni­cate. In my opin­ion, most tech­ni­cal writ­ers are not tak­ing advan­tage of tools like YouTube and Twit­ter. But in the com­ing years, more of us will under­stand how to mar­ry social media and tech­ni­cal doc­u­men­ta­tion. In the April edi­tion of Inter­com mag­a­zine, there’s an inter­est­ing arti­cle called “Under­stand­ing the Help 2.0 Rev­o­lu­tion.” It’s worth check­ing out: www.stc.org. The edi­tion is free too.

These are some of my ini­tial thoughts. How do you think tech­ni­cal writ­ing will change in the next decade?

Filed Under: Career Development, Help Authoring Tools, Online Collaboration, Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog, Search Engine Optimization, Technology Tagged With: cloud computing, FrameMaker, mobile, RoboHelp, smartphones, social media, technical writing changes, XML authoring

  • « 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,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.