A use case is a mechanism for recording the behavior of some system. It consists of a set of stakeholders with goals and shows the scenarios that may play out in completing those goals, the Main Success Scenario and Extenstions--alternate success scenarios and error cases. It provides a well defined method for producing requirements that fulfills several important criteria when properly written.
Guidelines for Writing use CasesThe following guidelines are excerpts from Writing Effective Use Cases by Alistair Cockburn, used with permission.RemindersWrite something readable.Casual, readable use cases are still useful, wheras unreadable use cases won't get read.Work breadth-first, from lower precision to higher precision.Precision Level 1: Primary actor's name and goal Precision Level 2: The use case brief, or the main success scenario Precision Level 3: The extension conditions Precision Level 4: The extension handling steps Capture the actor's intention, not the user interface details. Have an actor pass information, validate a condition, or update state. Write between-step commentary to indicate step sequencing (or lack of). Ask 'why' to find a next-higher level goal. For data descriptions (only put Precision Level 1 into the use case text):Precision Level 1: Data nickname Precision Level 2: Data fields associated with the nickname Precision Level 3: Field types, lengths and validations The Writing Process
Pass/Fail Tests for Use Case Fields
|