Tips for writing good use cases.
Use cases are part of the Object Management Group (OMG) Unied Modeling Language (UML) standard. This standard tells us what the parts of the use casediagrams mean—the stick gures, ovals and lines—and it gives us the denitionof a use case. But it doesn’t tell us how to structure or write one. So we’re left toread books or articles (like this one), to try to gure out the right way.So, what is the right way? The best way is the way that works for you—withoutstraying too far from the denition of what a use case is:
A use case is the specication of a set of actions performed by a system, which yields an observable result that is, typically, of value for one or more actors or other stakeholders of the system (UML 2).
A less formal denition might be: A use case is a list of steps that species how auser interacts with the business or system while keeping in mind the value thatthis interaction provides to the user or other stakeholders. Simpler still: A usecase is the story of how the business or system and the user interact. A use case is not to be confused with a user story, a software system require-ment formulated as one or two sentences in the everyday language of the user.Use cases are formal requirements with context and structure that clearlydene the resultant value.This still leaves use case writers with a big job—guring out the best way toactually write use cases, given the signicant ambiguity built into the denition.This paper’s goal is to help you make the right decisions so that you can success-fully do that job. Another type of use case—the business use case—is used to develop models thatdescribe how a business will interact with its customers and other external par-ties and provide value to these entities. This paper does not address business usecases and focuses exclusively on system use cases.