Mock-ups, Story Maps, Specs, & Sharpies

Some readings about
mock-ups & specification

• James Buckhouse's "Story Map"
• Jason Fried's "Sketching with a Sharpie"
• Joel Spolsky's "Painless Functional Specifications" series
• Francis Cortez's "Personal Design Sprint #1", #2, and #3
• Alexander Cowan's "Your Best Agile User Story"

By Monday…

1. Some kind of visual mock-up of your project, capturing user-flow and layout (e.g. how the think will be used and look). This could be a sketch — like the one I made for the physical pomes project. Or it could be a story map, a specification, or some other approach laid out in one of those readings.
2. Answers to the below questions.
   • What is your idea?
   • Who is its audience, and what do they value?
   • How will you know if it is successful?
   • What is your plan for going about it?

Cloning pomes
with git/GitHub Desktop

1. Go to github.com/dgmd/a-story-in-pomes and fork the repository
2. Open Github Desktop
3. Click through File > Clone Resository and then type in the name of the pomes repository (a-story-in-pomes)
4. Click Clone Repository
5. Now choose where you want the repository to be cloned and what you want it to be called, and click Clone again
6. At the top of GitHub Desktop, click the dropdown that currently reads master and instead choose gh-pages.
7. Now, using Finder, locate the new repository on your computer

Viewing pomes locally

1. Open Terminal; change directory into the a-story-in-pomes repository.
2. Run npm install; this looks at the package.json file and installs the various packages required for a-story-in-pomes
3. Run node server.js; this runs the file server.js, and will serve up a version of the pomes site locally.
4. Now, in Google Chrome, go to localhost:3000; this page will reflect any changes you make to the pomes project files on your computer.
5. Now, try making a change to the index.html file in the pomes repository and saving it to make sure the changes are being reflected.

pomes Extensions

1. Change Background Image & Content
2. Change Formatting of Byline Dates & Times
3. Fix Background Image Changing Algorithm
4. Pull in Images Using the Flickr API
5. Pull in Outside Media Using Another API
6. Rewrite Camera Functionality with New Tokens

Setting up your
development environment

1. On a Mac, run xcode-select --install in the application Terminal. On a Windows machine, install Babun.
2. Inside your terminal (Terminal.app on Mac, Babun on Windows), install Homebrew by running:

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. Run brew update, then brew doctor. Watch for any errors that come up.
4. Install Sublime Text 3, Google Chrome, GitHub Desktop, and Slack.
5. Open Sublime Text and install the Package Control plugin by following these directions.
6. Install the HTMLPrettify with these directions and then restart Sublime Text.