SE311 · Chapter 6 · Annotated SlidesWriting Excellent Requirements
Original
Overview

Writing Excellent Requirements

Characteristics of excellent individual requirements and requirement sets, guidelines on perspective, writing style, level of detail, representation techniques and avoiding ambiguity, and sample requirements before and after improvement.

How to read this page

Every original slide is shown unchanged. Yellow marks on a slide point to a numbered note: hover or tap a mark to jump to its note, and hover a note to see its marks. Questions tagged Past exam appeared on a real paper; Prediction questions are likely angles, not confirmed. Pick an answer to each question: a wrong pick tells you why it is wrong, so you can try again.

All 61 slides
  1. 1 Slide 1
  2. 2 Hi, Gautam. This is Ruth calling from the Austin branch. We got that latest drop of the website software for the online music “
  3. 3 RE Process
  4. 4 Characteristics of Excellent Requirements Complete
  5. 5 Characteristics of Excellent Requirements Correct
  6. 6 Characteristics of Excellent Requirements Feasible
  7. 7 Characteristics of Excellent Requirements Necessary
  8. 8 Characteristics of Excellent Requirements Prioritized
  9. 9 Characteristics of Excellent Requirements Unambiguous
  10. 10 Characteristics of Excellent Requirements Verifiable
  11. 11 Characteristics of Requirements Collections Complete
  12. 12 Characteristics of Requirements Collections Consistent
  13. 13 Characteristics of Requirements Collections Modifiable
  14. 14 Characteristics of Requirements Collections Traceable
  15. 15 Characteristics of Reuirements Collections
  16. 16 Guideline for Writing Requirements
  17. 17 Guidelines for Requirements
  18. 18 1- System or User Perspective
  19. 19 1- System or User Perspective
  20. 20 1- System or User Perspective
  21. 21 2- Writing Style
  22. 22 2- Writing Style
  23. 23 2- Writing Style - Tips
  24. 24 2- Writing Style - Tips
  25. 25 2- Writing Style - Tips
  26. 26 2- Writing Style - Tips
  27. 27 2- Writing Style - Tips
  28. 28 2- Writing Style - Tips
  29. 29 2- Writing Style - Tips
  30. 30 3- Level of Detail
  31. 31 3- Level of Detail
  32. 32 3- Level of Detail
  33. 33 3- Level of Detail
  34. 34 3- Level of Detail
  35. 35 3- Level of Detail
  36. 36 4- Representation Techniques
  37. 37 4- Representation Techniques
  38. 38 4- Representation Techniques
  39. 39 5- Avoiding Ambiguity
  40. 40 5- Avoiding Ambiguity – Sources
  41. 41 5- Avoiding Ambiguity – Sources
  42. 42 5- Avoiding Ambiguity – Sources
  43. 43 5- Avoiding Ambiguity – Sources
  44. 44 5- Avoiding Ambiguity – Sources
  45. 45 5- Avoiding Ambiguity – Sources
  46. 46 5- Avoiding Ambiguity – Sources
  47. 47 5- Avoiding Ambiguity – Sources
  48. 48 Sample Requirements, before and after
  49. 49 Sample Requirements, before and after
  50. 50 Sample Requirements, before and after
  51. 51 Sample Requirements, before and after
  52. 52 Sample Requirements, before and after
  53. 53 Sample Requirements, before and after
  54. 54 Sample Requirements, before and after
  55. 55 Sample Requirements, before and after
  56. 56 Sample Requirements, before and after
  57. 57 Sample Requirements, before and after
  58. 58 Sample Requirements, before and after
  59. 59 Sample Requirements, before and after
  60. 60 Sample Requirements, before and after
  61. 61 Sample Requirements, before and after
Slide 1 / 61

Slide 1

Slide 1: Slide 1
Slide 2 / 61

Hi, Gautam. This is Ruth calling from the Austin branch. We got that latest drop of the website software for the online music “

Slide 2: Hi, Gautam. This is Ruth calling from the Austin branch. We got that latest drop of the website software for the online music “
Slide 3 / 61

RE Process

Slide 3: RE Process
Slide 4 / 61

Characteristics of Excellent Requirements Complete

Slide 4: Characteristics of Excellent Requirements Complete

Notes

  1. Excellent requirement statements: complete, correct, feasible, necessary, prioritized, unambiguous, verifiable.

Exam angle

PredictionQ1

"The system shall be user-friendly" mainly fails to be:

Slide 5 / 61

Characteristics of Excellent Requirements Correct

Slide 5: Characteristics of Excellent Requirements Correct
Slide 6 / 61

Characteristics of Excellent Requirements Feasible

Slide 6: Characteristics of Excellent Requirements Feasible
Slide 7 / 61

Characteristics of Excellent Requirements Necessary

Slide 7: Characteristics of Excellent Requirements Necessary
Slide 8 / 61

Characteristics of Excellent Requirements Prioritized

Slide 8: Characteristics of Excellent Requirements Prioritized
Slide 9 / 61

Characteristics of Excellent Requirements Unambiguous

Slide 9: Characteristics of Excellent Requirements Unambiguous
Slide 10 / 61

Characteristics of Excellent Requirements Verifiable

Slide 10: Characteristics of Excellent Requirements Verifiable
Slide 11 / 61

Characteristics of Requirements Collections Complete

Slide 11: Characteristics of Requirements Collections Complete

Notes

  1. Excellent requirement SETS: complete, consistent, modifiable, traceable.

  2. Memory trick Statements: C-C-F-N-P-U-V. Sets: Complete, Consistent, Modifiable, Traceable.

Slide 12 / 61

Characteristics of Requirements Collections Consistent

Slide 12: Characteristics of Requirements Collections Consistent
Slide 13 / 61

Characteristics of Requirements Collections Modifiable

Slide 13: Characteristics of Requirements Collections Modifiable
Slide 14 / 61

Characteristics of Requirements Collections Traceable

Slide 14: Characteristics of Requirements Collections Traceable
Slide 15 / 61

Characteristics of Reuirements Collections

Slide 15: Characteristics of Reuirements Collections
Slide 16 / 61

Guideline for Writing Requirements

Slide 16: Guideline for Writing Requirements
Slide 17 / 61

Guidelines for Requirements

Slide 17: Guidelines for Requirements
Slide 18 / 61

1- System or User Perspective

Slide 18: 1- System or User Perspective
Slide 19 / 61

1- System or User Perspective

Slide 19: 1- System or User Perspective
Slide 20 / 61

1- System or User Perspective

Slide 20: 1- System or User Perspective
Slide 21 / 61

2- Writing Style

Slide 21: 2- Writing Style

Notes

  1. Style: one requirement per statement, active voice, "shall" for mandatory, consistent terms (glossary), avoid "and/or", "etc.".

Slide 22 / 61

2- Writing Style

Slide 22: 2- Writing Style
Slide 23 / 61

2- Writing Style - Tips

Slide 23: 2- Writing Style - Tips
Slide 24 / 61

2- Writing Style - Tips

Slide 24: 2- Writing Style - Tips
Slide 25 / 61

2- Writing Style - Tips

Slide 25: 2- Writing Style - Tips
Slide 26 / 61

2- Writing Style - Tips

Slide 26: 2- Writing Style - Tips
Slide 27 / 61

2- Writing Style - Tips

Slide 27: 2- Writing Style - Tips
Slide 28 / 61

2- Writing Style - Tips

Slide 28: 2- Writing Style - Tips
Slide 29 / 61

2- Writing Style - Tips

Slide 29: 2- Writing Style - Tips
Slide 30 / 61

3- Level of Detail

Slide 30: 3- Level of Detail

Notes

  1. Level of detail: enough that developers and testers share the same understanding; more detail for outsourced or safety-critical work.

Slide 31 / 61

3- Level of Detail

Slide 31: 3- Level of Detail
Slide 32 / 61

3- Level of Detail

Slide 32: 3- Level of Detail
Slide 33 / 61

3- Level of Detail

Slide 33: 3- Level of Detail
Slide 34 / 61

3- Level of Detail

Slide 34: 3- Level of Detail
Slide 35 / 61

3- Level of Detail

Slide 35: 3- Level of Detail
Slide 36 / 61

4- Representation Techniques

Slide 36: 4- Representation Techniques

Notes

  1. Use tables, decision tables, diagrams when text gets complicated.

Slide 37 / 61

4- Representation Techniques

Slide 37: 4- Representation Techniques
Slide 38 / 61

4- Representation Techniques

Slide 38: 4- Representation Techniques
Slide 39 / 61

5- Avoiding Ambiguity

Slide 39: 5- Avoiding Ambiguity

Notes

  1. Ambiguity sources: vague words (fast, user-friendly, flexible, robust, efficient), "support", "etc.", "and/or", negative requirements, boundary values.

  2. Trap Words like "fast", "easy", "flexible", "minimize", "several" are unverifiable until quantified.

Exam angle

PredictionQ1

Which is unambiguous?

Slide 40 / 61

5- Avoiding Ambiguity – Sources

Slide 40: 5- Avoiding Ambiguity – Sources
Slide 41 / 61

5- Avoiding Ambiguity – Sources

Slide 41: 5- Avoiding Ambiguity – Sources
Slide 42 / 61

5- Avoiding Ambiguity – Sources

Slide 42: 5- Avoiding Ambiguity – Sources
Slide 43 / 61

5- Avoiding Ambiguity – Sources

Slide 43: 5- Avoiding Ambiguity – Sources
Slide 44 / 61

5- Avoiding Ambiguity – Sources

Slide 44: 5- Avoiding Ambiguity – Sources
Slide 45 / 61

5- Avoiding Ambiguity – Sources

Slide 45: 5- Avoiding Ambiguity – Sources
Slide 46 / 61

5- Avoiding Ambiguity – Sources

Slide 46: 5- Avoiding Ambiguity – Sources
Slide 47 / 61

5- Avoiding Ambiguity – Sources

Slide 47: 5- Avoiding Ambiguity – Sources
Slide 48 / 61

Sample Requirements, before and after

Slide 48: Sample Requirements, before and after

Notes

  1. Before/after samples: split compound requirements, quantify quality attributes, remove design details, define terms.

Slide 49 / 61

Sample Requirements, before and after

Slide 49: Sample Requirements, before and after
Slide 50 / 61

Sample Requirements, before and after

Slide 50: Sample Requirements, before and after
Slide 51 / 61

Sample Requirements, before and after

Slide 51: Sample Requirements, before and after
Slide 52 / 61

Sample Requirements, before and after

Slide 52: Sample Requirements, before and after
Slide 53 / 61

Sample Requirements, before and after

Slide 53: Sample Requirements, before and after
Slide 54 / 61

Sample Requirements, before and after

Slide 54: Sample Requirements, before and after
Slide 55 / 61

Sample Requirements, before and after

Slide 55: Sample Requirements, before and after
Slide 56 / 61

Sample Requirements, before and after

Slide 56: Sample Requirements, before and after
Slide 57 / 61

Sample Requirements, before and after

Slide 57: Sample Requirements, before and after
Slide 58 / 61

Sample Requirements, before and after

Slide 58: Sample Requirements, before and after
Slide 59 / 61

Sample Requirements, before and after

Slide 59: Sample Requirements, before and after
Slide 60 / 61

Sample Requirements, before and after

Slide 60: Sample Requirements, before and after
Slide 61 / 61

Sample Requirements, before and after

Slide 61: Sample Requirements, before and after