Robert Desprez Communications

  • My Services
  • My Blog
  • About Me
  • Contact Me
You are here: Home / Help Authoring Tools / Which Output to Create: HTML5 or a Mobile App?

Which Output to Create: HTML5 or a Mobile App?

June 19, 2016 by RDesprez 3 Comments

Tweet

New Help Author­ing Tools can cre­ate out­put files, such as HTML5 Help, mobile apps, and EPUB files. In this blog post, I am going to touch on what I see are the strengths of HTML5 Help and mobile apps.

First, some def­i­n­i­tions are in order. A mobile appli­ca­tion, most com­mon­ly referred to as an app, is a type of appli­ca­tion soft­ware designed to run on a mobile device, such as a smart­phone or a tablet com­put­er. HTML5 is a markup lan­guage used for struc­tur­ing and pre­sent­ing con­tent on the World Wide Web and is sup­port­ed by all mod­ern browsers. When I refer to HTML5 Help, I am refer­ring to a help project that can be viewed on com­put­ers, tablets, and smartphones.

The fol­low­ing image shows a screen cap­ture of an app for a fic­ti­tious prod­uct called InfoPath.

Mobile_app_example

The next image shows an HTML5 Help project that is dis­played on a computer.

HTML5_example

Strengths of Creating an App

  • The pop­u­lar­i­ty of apps is unde­ni­able. Eighty-five per­cent of users said they pre­fer using apps com­pared to mobile web sites. In addi­tion, users are spend­ing more time using apps—an increase of 21 per­cent in 2015 com­pared to the pre­vi­ous year. Source: Business2Community
  • Ide­al for users who have an inter­mit­tent con­nec­tion to the Inter­net: Once the app is installed on a smart­phone or tablet, it no longer requires a wire­less or mobile con­nec­tion to view the con­tent. In con­trast, HTML5 Help sys­tems require a brows­er, which usu­al­ly needs an Inter­net con­nec­tion to view the con­tent (although some browsers, such as Google Chrome, can run in offline mode).
  • Speed: Users will get the answers they need faster using an app ver­sus launch­ing a brows­er, nav­i­gat­ing to your help page, and wait­ing for the con­tent to appear.
  • High­er vis­i­bil­i­ty: An app is installed on a user’s smart­phone or tablet, mak­ing it easy to locate and launch. In con­trast, an online help sys­tem is typ­i­cal­ly includ­ed in a soft­ware pack­age and may not be easy to find or open.
  • Easy to cre­ate: I’ve cre­at­ed apps in Robo­Help (2015 release) and FrameMak­er (2015 release). Once you have per­formed some con­fig­u­ra­tion steps in both pro­grams, cre­at­ing an app is straight­for­ward.  Note: If you plan to cre­ate iOS appli­ca­tions, you need to pur­chase an Apple devel­op­er account for $99 US per year.

Aside the pre­vi­ous list, there are oth­er issues to con­sid­er, such as how will your app be dis­trib­uted to users so they can view your content.

Strengths of HTML5 Help

  • HTML5 Help auto­mat­i­cal­ly adjusts to the user’s screen: Respon­sive HTML5 Help changes the way the con­tent is pre­sent­ed, based on the device the user is using. For exam­ple, when view­ing con­tent on a PC, a user sees online help with a tra­di­tion­al lay­out while some­one using a smart­phone will see a table of con­tents that is opti­mized for touch. Respon­sive HTML5 Help auto­mat­i­cal­ly adjusts to the user’s screen and adjusts to dynam­ic screen size changes, such as a flip of the ori­en­ta­tion or resiz­ing of the brows­er. As a tech­ni­cal writer, you can author new con­tent or take your lega­cy con­tent and quick­ly out­put it so that it can be viewed on PCs, Macs, and smart­phones and tablets run­ning iOS and Android.

responsive-devices

Source for image: http://techwhirl.com/adobe-technical-communication-suite-2015-release-profile/)

  • Low learn­ing curve: A tech­ni­cal writer cre­ates Respon­sive HTML5 Help in much the same way as tra­di­tion­al help projects, such as Web­Help or Microsoft HTML Help. For any writer that has cre­at­ed online help in the past, cre­at­ing respon­sive HTML5 Help is straight­for­ward. In con­trast, cre­at­ing a mobile app requires some addi­tion­al con­fig­u­ra­tion steps, includ­ing pur­chas­ing an Apple devel­op­er account for iOS applications.
  • Con­sis­tent user expe­ri­ence across plat­forms: When using FrameMak­er or Robo­Help (2015 releas­es), one of the ben­e­fits of respon­sive HTML5 Help is it enables users to expe­ri­ence a sim­i­lar help system—including brand­ing and cor­po­rate col­ors that you can eas­i­ly customize—across devices. Whether your users are run­ning a PC, Mac, smart­phone, or tablet, the respon­sive HTML5 Help pro­vides a con­sis­tent user experience.

 

Filed Under: Help Authoring Tools, Online Writing for Mobile, Robert Desprez | Vancouver technical writer | Blog Tagged With: FrameMaker, HTML5 Help, mobile apps, RoboHelp

Comments

  1. Niels Grundtvig Nielsen says

    June 20, 2016 at 10:00 am

    The app cer­tain­ly looks good … but I do won­der when, in a soft­ware con­text, peo­ple would want to be read­ing the help con­tent on their GSM if they aren’t already using the appli­ca­tion the help belongs to? giv­en the dif­fi­cul­ty we usu­al­ly have per­suad­ing users to read any help infor­ma­tion at all.

    One of the help sets I deliv­er at the moment is for a PC-based appli­ca­tion for use in on a secure PC with no inter­net con­nec­tion – start­ing from DITA-com­pli­ant XML and the excel­lent XML Mind edi­tor, I deliv­er stand-alone Web­Help that seems to meet require­ments. I sup­pose the zeal­ous user could then copy this on to a ‘phone or tablet, but I haven’t heard that any­one has both­ered trying :-}

    Reply
  2. Matt Sullivan says

    June 26, 2016 at 8:01 pm

    Great arti­cle, Robert!

    As you know (thanks for attend­ing!), I did a 3‑part series for Adobe on FrameMak­er dig­i­tal publishing.

    For those who’d like more detail on set­ting up, cus­tomiz­ing, and pro­duc­ing HTML5 and mobile apps, links to all the posts, record­ings, and videos are at

    http://www.techcommtools.com/publishing-overview/

    -Matt Sul­li­van
    Tech Comm Tools
    Author, FrameMak­er — Cre­at­ing and Edit­ing Con­tent (2015)

    Reply
  3. Robert Desprez says

    July 6, 2016 at 4:53 am

    Hi Niels and Matt,

    Thanks for your comments!

    Robert

    Reply

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

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,204 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 ·
11 Apr 2043062547159589215

ChatGPT vs. Gemini: I Tested Both, and the Winner Might Surpise You

Curious about AI chatbots but don’t know where to start? ChatGPT and Gemini are two of the best, and I'm her...

www.pcmag.com

Reply on Twitter 2043062547159589215 Retweet on Twitter 2043062547159589215 0 Like on Twitter 2043062547159589215 0 Twitter 2043062547159589215
robert_desprez avatar; Robert Desprez @robert_desprez ·
22 Mar 2035801301733527930

Image for twitter card

Remote work can help offset oil price shock, IEA says | LinkedIn

The International Energy Agency has outlined 10 strategies to help oil-consuming nations mitigate the impact of rising prices.

www.linkedin.com

Reply on Twitter 2035801301733527930 Retweet on Twitter 2035801301733527930 0 Like on Twitter 2035801301733527930 0 Twitter 2035801301733527930
robert_desprez avatar; Robert Desprez @robert_desprez ·
21 Mar 2035393914396692588

‘Microshifting’ puts a new spin on 9-to-5 schedules

Image for twitter card

‘Microshifting’ puts a new spin on 9-to-5 schedules

A new way of scheduling work time is remaking the typical nine-to-five routine. “Microshifting” is a trend that ...

apnews.com

Reply on Twitter 2035393914396692588 Retweet on Twitter 2035393914396692588 0 Like on Twitter 2035393914396692588 0 Twitter 2035393914396692588
robert_desprez avatar; Robert Desprez @robert_desprez ·
16 Mar 2033691191984984182

The cost of digital disorganization is nearly a month of productivity per year

Image for twitter card

The cost of digital disorganization is nearly a month of productivity per year

The problem often stems from unclear systems and ownership inside organizations, but simple habits and clearer workflo...

www.theglobeandmail.com

Reply on Twitter 2033691191984984182 Retweet on Twitter 2033691191984984182 0 Like on Twitter 2033691191984984182 0 Twitter 2033691191984984182
Load More

Recent Blog Posts

  • Using ChatGPT to read smarter
  • ChatGPT: The AI-powered proofreader
  • Four ways Confluence could be better
  • First impressions of MadCap’s purchase of IXIASOFT

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 © 2026  · Robert Desprez Communications Inc.