Functional Spec for Mason News iOS App

This is the functional specification for the update to our Mason County News iOS application. The format is based on an excellent template created by Joel Spolsky.

Mason County News is an iOS universal application that runs on an iPad or iPhone.  It is designed to pull the latest Mason County news from the Mason TX County News web site at via the paper’s RSS feed.

The results of the feed will be stored in local core data, the articles and pictures from the feed will also be downloaded and stored locally, with extra html and other data removed for easier viewing when offline. All updates from the site will be running as background threads….
This spec is not, by any stretch of the imagination, complete. All of the wording will need to be revised several times before it is finalized. The graphics and layout of the screens is shown here merely to illustrate the underlying functionality. The actual look and feel will be developed over time with the input of graphics designers and iterative user feedback.

In designing products, it helps to imagine a few real life stories of how actual (stereotypical) people would use them. We’ll look at one scenario…
Scenario 1: Mike.
Mike is a busy executive who was born and grew up in Mason, TX but now lives in Paris France. He still has friends and relatives in Mason and likes to keep up to date on what is going on back in his home town. He reads news on the go on his iPhone or sometimes at home or in his private jet on his iPad. He also likes to share articles via MMM or email with his beautiful French girlfriend so she can practice her English. He likes to read articles offline as well as online.

Non Goals
This version will not support the following features:

  • different languages

Mason News Flowchart
We’ll have time later to go into mind-numbing detail, but for now, let’s look at a quick flowchart of the service so you get the big picture. This flowchart is not complete, but it does give you the right idea for the “storyboard” of using Mason News on your iOS device.


Screen by Screen Specification
Mason New consists of quite a few different screens. Most screens will follow a standard format, with a look and feel to be designed in the future by a graphic designer. This document is more concerned with the functionality and the interaction design, not the exact look and layout.
All screens are created in the XCode interface builder. (The single exception is the Splash Screen, which is created using GIMP).
Each screen in Mason News is known by a canonical name which will always appear, in this document, with an underline, so you know we’re referring to a screen by name, for example, Home Page.

Default Splash
An image of the Mason TX courthouse or other appropriate image – just is displayed during initial load of application, and when first load of rss feed on first start of app.

Home Page
Displayed when app load is complete – looks like below (shows list of all newsitems in the database, sorted by most recent on top) – some items may  not have pictures

Technical Note – 
All updates are in the background – starts empty

Read Article
Picking an article – will load it in the viewer – view will be scrollable down and will contain links as appropriate, also pictures (using  uiwebview)
While reading an article you can share it. share via twitter, facebook, mmm, email, google +, etc

Share Article

About App
Simple page with picture same as splash – then credits and info about Mason and the newspaper