Session Summary: Getting Started with User Assistance (UA) for Mobile Applications

TechWhirl’s coverage of WritersUA 2012 is sponsored by Madcap Software. Find out more and download a trial copy of Flare 8.

Presenter: Joe Welinske, WritersUA

Effective mobile user assistance (UA) requires a shift from traditional UA thinking, and according to Joe Welinske, that shift includes a focus on usability, word choice and a bit of zen. Welinske’s session on getting started with mobile UA, delivered at WritersUA, provided great foundational guidance on what to consider in planning, designing and building mobile UA. He gave us an example of a company he’d worked with that used a payroll iOS app to accomplish their individual users’ very specific time tracking goals.

Get zen. Joe emphasized repeatedly that mobile UA must be concise. It’s important to “boil down” your text and reduce information given to the bare minimum. If you can, get it all the way down to verbs and nouns. In the same way, you’ll want to remove as much extraneous numbering and punctuation as possible, both for space reasons and because they often just don’t look right in the context of a mobile application.

UA for mobile can run the gamut, from assistance for “sidecar apps” that complement large, traditional applications, to assistance for more complicated and powerful apps, especially for iPad. In the mobile world, there’s a lot of competition, and thus less time to impress.

Usability testing, even if informal, is key to the success of your UA. There’s really nothing like getting your app in front of the user and watching them try to solve problems. For example, Joe found while testing that more than one screen of pure information annoys the user. They want it all in one place. Of course, that makes your job as a writer difficult.

Word choice turned out to be massively important. A “hide” button worked better than the original “dismiss” button for a timer within the app. “Text color” worked better than “font color.” Although there is a difference in the meaning of the words, it turned out “text” was clearer to a larger number of people.

Emphasize tasks through the use of color and bold text. This signals the user to pay attention, drawing the eye and allowing the user to quickly parse information.

In a mobile app, help is often banished to a dark corner of a submenu. Obviously, this makes it difficult for your user to get the help they need! Consider requesting that the programmers add functionality, such as a [?] button, to your app so that users can easily access it.

In order to develop for iOS, you will need the following:


  • Lion
  • Xcode from App Store: iPhone SDK
  • iPhone/iPad


  • Interface Builder
  • Objective-C
  • WebKit

Welinske noted that there are many more opportunities for user assistance on the iPad due to its increased screen size. Companies getting started with mobile development should look into Android, Kindle, and Windows Phone user assistance development as well. Android can be more difficult to develop in than iOS is. On the other hand, the Windows platform is just as easy and intuitive as working in iOS, but the platform hasn’t really taken off just yet.

The bottom line: No matter what platform your company’s mobile application is running on, remember to keep your mobile UA as concise and intuitive as possible.


Ashley Brown

Ashley Full Stop Brown hates it when people run her names together. In addition to her responsibilities as a full-time Professional Writing major and Computer Science minor at the University of Memphis, she edits all the things at Edits, Full Stop and creates jewelry for Woodvine Design. Her clients have been published in Stone Telling, Goblin Fruit, and Apex Magazine, among others. She will graduate with a Bachelor of Arts degree in 2013. Ashley is an enthusiastic proponent of mobile applications and their myriad uses and does not believe paper books are any better than ebooks. She excels at the art of taking a pile of words and turning them into a finished, clear, interesting document. She has read the Chicago Manual of Style from cover to cover, and will fight for the right to use her beloved Oxford comma. When she is not writing for TechWhirl, doing homework, polishing documents until they shine, wrapping various objects in wire, or wrangling her adorable toddler, she is likely to be found with a book and a glass of wine on her porch in Memphis, Tennessee.

Read more articles from Ashley Brown