Completed user stories - discard? archive? [closed]
Asked Answered
S

10

5

We are starting to use a Scrum process for development. We have a nice stack of user stories now . I'm wondering though, once a user story is complete, tested and deployed do you do anything else with it? We're using little index cards right now, I'd think it would be fine to just toss them in the trash can.

If you keep them, what do you do with them later?

Supplicatory answered 7/1, 2009 at 23:59 Comment(0)
S
11

Archive them for reference on future projects. They will be useful when you have to estimate story points. Often times, similar-sounding stories occur across projects.

Shortwave answered 8/1, 2009 at 0:9 Comment(4)
A team's velocity changes with experience and personnel changes. Old estimates are not really useful.Groan
My answer is within the context of a relatively stable team.Shortwave
+1: Experience-Based Estimating. This is your baseline data. Original story and final cost to implement.Ironsmith
@Shortwave - I can accept that - I've just never worked on one :)Groan
T
6

Um - keep them and put them in the project file. CYA in all cases. You never know when a client will come back and ask you "why is this this way?", or "who decided that was how it was?". You can then pull out the user story and have backup.

Always keep everything like this until the warranty period has expired on your software... unless you want to be put in the position where you could be asked to "fix" something that was really a change for free.

Tenor answered 8/1, 2009 at 0:15 Comment(0)
S
1

The trash can seems like an appropriate place.

Stingo answered 8/1, 2009 at 0:1 Comment(0)
G
1

PEZ is almost right. Recycle the cards rather than trash them. :)

There really is no point in keeping them. If you need a history of changes you can get that from your SCM and test scripts.

Groan answered 8/1, 2009 at 0:11 Comment(0)
S
1

Another vote for keeping them. I know it's a dirty word, but the user stories are part of your documentation, and serve an important purpose.

Three years from now when you (or the inheritor) are making changes to the system it's helpful to have the historic documents to know why you did things the way you did.

It also helps when the situation changes and you have to rewrite to be able to go back over the user stories that the application satisfies and determine whether or not those same stories apply to the new version.

Sevastopol answered 8/1, 2009 at 2:9 Comment(0)
T
1

I usually wrap each iterations worth of user stories (and tasks) in a rubber band and a new card in front stating the velocity and estimated points. I've never had any use for them though, except for nostalgic reasing. So keep them for the archive I'd say :-9

Titbit answered 9/1, 2009 at 13:59 Comment(0)
B
1

Hang on to them!

I write requirements (rather than code), but I frequently find myself rereading old user stories and acceptance tests (mine and others').

Reviewing old stories can help me find the clearest phrasing for complicated concepts, rather than reinventing the wheel. They sometimes serve as a useful reminder for details I might otherwise forget to document. Stories written by others help me come up to speed on features I wasn't involved in, and will probably be a good learning tool for new hires.

I could go on, but let me just put it this way:
Which is more likely to cause greater problems -- keeping the stories and not needing them, or needing the stories and not having them?

Baseborn answered 1/2, 2010 at 0:14 Comment(0)
P
0

Keep them (archive them) so that if there is a dispute or argument over something in the future, you have a reference to it, and can cover yourself.

Priggish answered 8/1, 2009 at 0:2 Comment(3)
Dispute? I'd say that if the system doesn't work like the PO wants it it's time for writing a new user story (or maybe file a bug if it's more like that). What's written on an accepted user story card is just irrelevant.Stingo
Sounds like the exact opposite philosophy to any agile process. You sure you aren't talking about requirements documents from a waterfall process?Olivas
I'd say this is realistic in the scenario where you're introducing agile to a madly-waterfall-based company and to help resolve any teething problems.Rustyrut
D
0

Completed user stories are essentially the final specification for your project. If you started with a formal requirements document or specification, there are many lessons to be learned by comparing your completed user stories with that document. If you don't have an initial document, then your completed user stories document the functionality of your project. In either case, I think it's very valuable to hang on to them for future reference, whether in project post-mortems or when estimating and planning subsequent projects.

Disulfide answered 8/1, 2009 at 2:28 Comment(0)
V
0

I find that we never know what's going to be useful in the future, so my recommendation is to tag them and file them. If you're using physical cards, scan them then do something as simple as adding a tag to the image file. Imagine looking at a tag cloud later to find common threads or to locate and re-use your content.

As with all things scrum, though, if it starts taking too much time, it's probably not worth your effort. Don't make it a crazy process, just quickly file it and forget it.

Cheers, Reeves

Various answered 8/1, 2009 at 3:14 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.