My Authors
Read all threads
Let's look at how to write a good story by looking at a bad one. "As a user I need to save so that I won't lose my work" is wrong at several levels. First "user" is meaningless. What you want is a concrete role (e.g. "author"). Next, "saving" is a how. 1/7
The story should specify what you need to do, not how to do it. That brings us to "Authors need to work on a document over several sessions." You could do that with saving, I suppose, but you could do it in better ways, 2/7
by just launching in whatever state the program was in when you last shut it down, for example. Quicken doesn't have a save. That's a good thing. Who would want to throw away their work if they don't do some not-very-obvious-to-a-normal-human-being operation? Also, 3/7
"save" is an operation performed on a computer program. Stories need to be in the domain. If your domain is writing, a good underlying metaphor is an old-fashioned typewriter. No typewriters fed your work into a shredder when you got up to get a cup of coffee. 4/7
When you came back to work, the paper you were working on was there. The program needs to model that domain, and describing some computer program is not going to help us with that. 5/7
Finally, there's the "why." Not losing work is a given. The real why, here, "so they can write long or complex documents" or equivalent. That "why" brings up all sorts of issues (long? complex?) that wouldn't come up with the initial example. 6/7
So, the basics are who, what, and why, and keep it in the domain. Don't describe a computer program. "Authors need to work on a document over several sessions so that they can express long, complex thoughts" works for me. 7/7
Missing some Tweet in this thread? You can try to force a refresh.

Enjoying this thread?

Keep Current with Allen Holub

Profile picture

Stay in touch and get notified when new unrolls are available from this author!

Read all threads

This Thread may be Removed Anytime!

Twitter may remove this content at anytime, convert it as a PDF, save and print for later use!

Try unrolling a thread yourself!

how to unroll video

1) Follow Thread Reader App on Twitter so you can easily mention us!

2) Go to a Twitter thread (series of Tweets by the same owner) and mention us with a keyword "unroll" @threadreaderapp unroll

You can practice here first or read more on our help page!

Follow Us on Twitter!

Did Thread Reader help you today?

Support us! We are indie developers!


This site is made by just three indie developers on a laptop doing marketing, support and development! Read more about the story.

Become a Premium Member ($3.00/month or $30.00/year) and get exclusive features!

Become Premium

Too expensive? Make a small donation by buying us coffee ($5) or help with server cost ($10)

Donate via Paypal Become our Patreon

Thank you for your support!