Robert Desprez Communications

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

Three Challenges of Writing for Mobile

November 30, 2017 by RDesprez Leave a Comment

Now that Android is the lead­ing oper­at­ing sys­tem used to con­nect to the Inter­net, tech­ni­cal writ­ers need to seri­ous­ly look at how their con­tent is being dis­played on smart­phones and tablets.

For years, smart­phone and tablet use has sky­rock­et­ed.  In 2016, the num­ber of smart­phone users was expect­ed to sur­pass 2 bil­lion (source: eMar­keter). Sim­i­lar­ly, there are about 1.5 bil­lion peo­ple who are expect­ed to use a tablet by 2019 (source: eMar­keter). Ear­li­er this year, Android has edged out Win­dows as the num­ber one oper­at­ing sys­tem used to access the Inter­net.

Mean­while, tech­ni­cal writ­ers appear to be slow to embrace mobile. In one study com­plet­ed last year of more than 700 tech­ni­cal com­mu­ni­ca­tion pro­fes­sion­als, only 24 per­cent of tech­ni­cal writ­ers pub­lish con­tent that would be con­sid­ered “mobile ready.”

Although there may be an unde­ni­able user demand for every­thing mobile, prepar­ing con­tent has its share of challenges.

Challenge Number One: Small Screen

In spite of the mod­ern trend towards larg­er-screen phones, what makes mobile phones so con­ve­nient and portable is their small size. Com­pared with desk­top and even lap­top screens, phone screens accom­mo­date a lot less content—see the fol­low­ing illus­tra­tion com­par­ing the sizes of mon­i­tors, tablets, and smartphones.

As a result, mobile users must work hard­er to access the same infor­ma­tion and rely on their short-term mem­o­ry to refer to infor­ma­tion that is not vis­i­ble on the screen.

One way to mit­i­gate users’ small screens is to embrace brevi­ty. One usabil­i­ty con­sul­tant rec­om­mend­ed that if you write 100 words for a print-based doc­u­ment, con­sid­er writ­ing 50 words for the web. For mobile, aim to reduce the word count even more.

Challenge Number Two: Comprehension

Jakob Nielsen, a usabil­i­ty con­sul­tant, has per­formed some stud­ies on user com­pre­hen­sion lev­els on mobile devices.

In a recent study, he found that, on aver­age, com­pre­hen­sion scores were slight­ly high­er when users read the arti­cles on mobile devices. How­ev­er, dif­fi­cult con­tent may cause low­er com­pre­hen­sion on mobile.

The dif­fi­cul­ty of the arti­cles (“easy” or “hard”) was deter­mined by the num­ber of words and the dif­fi­cul­ty of the lan­guage used (accord­ing to the Flesch-Kin­caid read­ing-lev­el for­mu­la). All of the arti­cles were pre­sent­ed as HTML pages cre­at­ed from the same sim­ple design template.

Easy pas­sages were read about as fast on both devices, but hard pas­sages actu­al­ly took longer to read on a mobile device ver­sus a com­put­er.  Easy arti­cles were about 400 words and writ­ten at a Grade 8 lev­el. Hard arti­cles were just under 1,000 arti­cles and at a Grade 12 level.

I would argue that tech­ni­cal com­mu­ni­ca­tion would typ­i­cal­ly fall into the hard category.

The take­away for me is again to sim­pli­fy your con­tent and to get to the point. You’re ask­ing a lot if you write a 1,000-word arti­cle when you know that some users will be read­ing the con­tent on a 5‑inch screen.

Challenge Number Three: Distraction Levels

Smart­phones have rev­o­lu­tion­ized how we live. But as mobile phones are portable, we are more like­ly to be inter­rupt­ed when using them. Nielsen notes that the aver­age user may be using a desk­top for more than 150 sec­onds while the aver­age mobile ses­sion dura­tion is just 72 seconds.

Nielsen rec­om­mends:

  • Allow users to save his­to­ry, as well as to email or share infor­ma­tion with them­selves or others.
  • Pri­or­i­tize what is essen­tial on a page and sim­pli­fy tasks and inter­ac­tions. Because atten­tion is frag­ment­ed, strive to show users what they need as soon as possible.

As users are more and more like­ly to read tech­ni­cal com­mu­ni­ca­tion on a mobile device, it’s an excit­ing time for tech­ni­cal writ­ers to learn new skills and approaches.

Filed Under: Career Development, Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: mobile, research, smartphones, tablets, technical communications, technical writing, writing

Is writing for mobile the next big thing?

April 29, 2012 by RDesprez 10 Comments

With all the news about the sky­rock­et­ing demand for smart­phones over­tak­ing com­put­er pur­chas­es, you might think that tech­ni­cal writ­ers would increas­ing­ly need to focus on writ­ing and deliv­er­ing user assis­tance for mobile devices.

For tech­ni­cal writ­ers, writ­ing for mobile appears to be the next big thing. Here are a few examples:

  • Mobile devices will be the pri­mary con­nec­tion tool to the Inter­net for most peo­ple by 2020, accord­ing to the Pew Research service.
  • Ref­er­ences to mobile phones and tablets are abun­dant at the Writ­er­sUA con­fer­ence and the upcom­ing Soci­ety for Tech­ni­cal Com­mu­ni­ca­tion conference.
  •  Help author­ing tools such as Mad­Cap Flare and Robo­Help tout that they sup­port pub­lish­ing con­tent for mobile devices using the ePub output.
  • There’s even a book ded­i­cat­ed to the top­ic called Devel­op­ing User Assis­tance For Mobile Apps by Joe Welinske.

So along with social media, one might think that cre­at­ing user assis­tance for mobile devices will rev­o­lu­tion­ize the way we work. There’s one prob­lem though.  In the last year, I have yet to see one job descrip­tion in Van­cou­ver that explic­it­ly refers to prepar­ing con­tent for mobile devices. When it comes to tech­ni­cal writ­ing oppor­tu­ni­ties, Van­cou­ver is no Sil­i­con Val­ley but it’s not unusu­al to see five to 10 adver­tised jobs per month.

I don’t think any­one can argue that cre­at­ing user assis­tance for mobile devel­op­ment is too new. Accord­ing to Apple’s web site, there are report­ed­ly 500,000 appli­ca­tions for the iPhone and iPad. There are also thou­sands of appli­ca­tions that run on the Android oper­at­ing sys­tem.  And smart­phones have been avail­able for years. So why is there not a surge in demand for user assis­tance for mobile devices? Some guesses:

  • Soft­ware devel­op­ers are writ­ing the con­tent. While the user assis­tance writ­ten by devel­op­ers may not be pro­fes­sion­al­ly writ­ten and for­mat­ted, per­haps man­age­ment feels that the con­tent  is “good enough”? After all, if a mobile app requires a lot of doc­u­men­ta­tion, it prob­a­bly means that it’s dif­fi­cult to use. Users expect apps to be simple.
  • Per­haps writ­ing for mobile is not big as pre­dict­ed. Employ­ers in Van­cou­ver are not clam­or­ing for writ­ers with mobile expe­ri­ence.  To be fair, I searched for “tech­ni­cal writer mobile” on the U.S. job site www.dice.com and found that 41 of 649 jobs men­tioned “mobile” in the job descrip­tions. Hard­ly a tsunami!
Do you think writ­ing user assis­tance for mobile will be the next thing? Why is there not a stronger demand? I’d be inter­est­ed in your thoughts.

 

Filed Under: Help Authoring Tools, Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog, Technology Tagged With: career development, smartphones, technical writing, writing for mobile

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

  • 1
  • 2
  • 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,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.