Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.
-
Upload
alannah-stevens -
Category
Documents
-
view
216 -
download
1
Transcript of Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.
![Page 1: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/1.jpg)
Documentation inthe Waterfall and Spiral methods
Steven BoyerUAH - CPE658 – Spring 2012
1
![Page 2: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/2.jpg)
Overview of Processes
2
![Page 3: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/3.jpg)
What’s what?
• Waterfall– Early model– Invites failure – all
testing at the end of the project
– All requirements realized up front
– No room for error– Requirements
developed, everything works to that
3
![Page 4: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/4.jpg)
4
![Page 5: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/5.jpg)
5
![Page 6: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/6.jpg)
What’s what? – cont.
• Spiral– Envisioned by Barry Boehm (1986)– Waterfall-like, over iterations– “Documents [are] produced when they are required… All
documents will not be created at the beginning of the process, nor all at the end (hopefully). Like the product they define, the documents are works in progress. The idea is to have a continuous stream of products produced and available for user review.” - NASA Software Safety Guidebook.
• NASA-GB-8719.13, March 31, 2004
– Based around risk assessments6
![Page 7: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/7.jpg)
7
![Page 8: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/8.jpg)
What’s what? – cont.
• Agile– Small builds over the course of a small period of time– Implement small number of features at a time– Examples
• Zombies• iAds• WiFi
– Working software over big documents– Less documents produced vs. other methods
• Customer involved more closely• Doesn’t need to have a formal document as they’re with the team
every meeting
8
![Page 9: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/9.jpg)
What’s what? – cont.
9
![Page 10: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/10.jpg)
Everyone’s favorite topic:Documents!
10
![Page 11: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/11.jpg)
Why?
• Show that you have some kind of process• That you’re developing it to spec.• Every requirement has a place and is tested• It’s required (internal purpose, deliverable, for
CPE658 grade, etc.)
11
![Page 12: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/12.jpg)
Which Ones Will This Presentation Highlight?
• SRS –Requirements – what the project is built to
• SDP – Design Plan – How it’s going to be built• SDD – Design Document – How it’s been built• STP – Test Plan – How it’s going to be tested• STD – Test Description – How to test it
12
![Page 13: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/13.jpg)
Quick Note About Information Regarding Agile Process
• I e-mailed back and forth with Alex Mabry (Software Engineer with Adtran)– “Nope. We aren't required to produce any of
those.”• E-mailed with Jay Olive (works on project
using Agile at the Software Engineering Directorate and has document requirements)
• Questions went un-answered– E-mails ignored
13
![Page 14: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/14.jpg)
Requirements SpecificationsWaterfall
• Built early into the project• All future work is tied to this document• If a feature is implemented that isn’t directly
tied to this, can be seen as a waste of time that can be spent elsewhere
• Requirements Phase
14
![Page 15: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/15.jpg)
15
![Page 16: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/16.jpg)
Requirements SpecificationsSpiral
• In the Development & Test quadrant,• In the Next Iteration Quadrant• In the Requirements Quadrant
• Repeats over every arc
16
![Page 17: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/17.jpg)
17
![Page 18: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/18.jpg)
Development PlanWaterfall
• Document on how you plan to develop the project
• Activities outlined and detailed• Changes are going to happen and document is
expected to be revised over the course of the project
• Design Phase
18
![Page 19: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/19.jpg)
19
![Page 20: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/20.jpg)
Development PlanSpiral
• Updated in the Next Iteration Quadrant after an arc finishes
• Incremental and repeats every arc
20
![Page 21: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/21.jpg)
21
![Page 22: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/22.jpg)
Design DocumentWaterfall
• Detailing HOW the project is designed• Classes, algorithms, data structures, etc.
• Spans over the Design and Implementation Phases
22
![Page 23: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/23.jpg)
23
![Page 24: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/24.jpg)
Design DocumentSpiral
• Development & Test Quadrant– Drafted after several arcs
• Again, iterative
– Each arc is a prototype• Iterating towards the final goal of a well-designed
system that’s well documented
– Completed in the final stages of the last arc
24
![Page 25: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/25.jpg)
25
https://uah-course-scheduler.googlecode.com/svn/trunk
![Page 26: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/26.jpg)
Test PlanWaterfall
• How you are going to test• Describes the plans for the Formal
Qualification Test
• Verification Phase
26
![Page 27: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/27.jpg)
27
![Page 28: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/28.jpg)
28
![Page 29: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/29.jpg)
Test PlanSpiral
• Development & Test Quadrant– Over all arcs
• Next iteration Quadrant before the last arc starts
29
![Page 30: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/30.jpg)
30
![Page 31: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/31.jpg)
Test DescriptionWaterfall
• Describes the test preparations, test cases, and test procedures to do a formal test
• Verification Phase
31
![Page 32: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/32.jpg)
32
![Page 33: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/33.jpg)
33
![Page 34: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/34.jpg)
Test DescriptionSpiral
• Development & Test Quadrant on the last arc• Developed over each arc
34
![Page 35: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/35.jpg)
35
![Page 36: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/36.jpg)
Summary
36
![Page 37: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/37.jpg)
SRS
Waterfall• First step: the requirement
phase
Spiral• Development & Test
quadrant• Next Iteration Quadrant• Requirements Quadrant
• OVER EVERY ARC
37
![Page 38: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/38.jpg)
SDP
WaterfallSecond Step: Design phase
SpiralNext Iteration Quadrant after
an arc
38
![Page 39: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/39.jpg)
SDD
Waterfall• Third Step: Design and
Implementation phases
Spiral• Development & Test
Quadrant drafted after several arcs, finished up along the last arc
39
![Page 40: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/40.jpg)
STP
WaterfallFourth Step: Verification phase
SpiralDevelopment & Test Quadrant
across arcsNext Iteration Quadrant before
the last arc starts
40
![Page 41: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/41.jpg)
STD
WaterfallFourth Step: Verification phase
SpiralDevelopment & Test Quadrant
on the last arc
41
![Page 42: Documentation in the Waterfall and Spiral methods Steven Boyer UAH - CPE658 – Spring 2012 1.](https://reader033.fdocuments.in/reader033/viewer/2022042821/56649f4a5503460f94c6bf70/html5/thumbnails/42.jpg)
Questions?
42