Natural Language • Use language in a consistent way. Use shall for mandatory requirements, should for desirable requirements. • Use text highlighting to identify key parts of the requirement. • Avoid the use of computer jargon (clarity) • Include an explanation (rationale) of why a requirement is necessary. • Split large stories into multiple smaller user stories • Customer is available for clarification
Example (good) • As a user, I can backup my entire hard drive. • As a power user, I can specify files or folders to backup based on file size, date created and date modified. • As a user, I can indicate folders not to backup so that my backup drive isn't filled up with things I don't need saved.
Example (better) • 3.2 The system shall measure the blood sugar and deliver insulin, if required, every 10 minutes. (Changes in blood sugar are relatively slow so more frequent measurement is unnecessary; less frequent measurement could lead to unnecessarily high sugar levels.) • 3.6 The system shall run a self-test routine every minute with the conditions to be tested and the associated actions defined in Table 1. (A self-test routine can discover hardware and software problems and alert the user to the fact the normal operation may be impossible.)
Example (better) • 3.2 The system shall measure the blood sugar and deliver insulin, if required, every 10 minutes. (Changes in blood sugar are relatively slow so more frequent measurement is unnecessary; less frequent measurement could lead to unnecessarily high sugar levels.) • 3.6 The system shall run a self-test routine every minute with the conditions to be tested and the associated actions defined in Table 1. (A self-test routine can discover hardware and software problems and alert the user to the fact the normal operation may be impossible.) Did you notice: What and Why but not How (not at computer level)
with User Stories It is all about writing skills: • Lack of clarity. Precision is difficult without making the document difficult to read. • Requirements confusion. Functional and non- functional requirements tend to be mixed-up. Or non-functional tend to be ignored • Requirements amalgamation. Several different requirements should not be expressed together.
Unified Modeling language (UML) is a standardized modeling language enabling developers to specify, visualize, construct and document artifacts of a software system.
Case Diagram • A use case is an scenario • A use cases identify actors (user roles and/or systems) • A use case identify sets of related requirements and their interconnections