Activity: Capture a Common Vocabulary

Roles and Activities > Analyst Role Set > System Analyst > Capture a Common Vocabulary

Purpose To define a common vocabulary that can be used in all textual descriptions of the system, especially in use-case descriptions.
Steps Find Common Terms Evaluate Your Results
Input Artifacts: Use-Case Model Vision Business Case Business Use-Case Model Business Object Model Stakeholder Requests Use Case Business Rules	Resulting Artifacts: Glossary
Role: System Analyst
Tool Mentors: Capturing a Common Vocabulary Using Rational RequisitePro

Workflow Details:

Requirements

Analyze the Problem

Define the System

Understand Stakeholder Needs

Find Common Terms

In the Requirements discipline, you must define a common vocabulary using the most common terms in the problem domain. You should then consistently use the common vocabulary in all textual descriptions of the system, especially in use-case descriptions. In this way, you keep the textual descriptions consistent and avoid misunderstandings among project members about the use and meaning of terms. You should document the vocabulary in a glossary.

To find common terms in the problem domain, consider terms used in the requirements and the development team's general knowledge of the system to be built. Focus on terms describing the following concepts:

Business objects representing concepts used in the organization's daily work or in the system's expected operating environment. In many cases, a list of concepts of this kind already exists.
Real-world objects that the system needs to be aware of. These objects occur naturally, and include such things as: car, dog, bottle, aircraft, passenger, reservation, or invoice.

Example:

In a Depot-Handling System, conversation is about, among other things, the items in the depot and potential storage locations for them.

Events that the system needs to be aware of. By "event" is here meant a point in time or a chronological incident that the system must know of, such as a meeting, or an error occurring.

Example:

A natural event in a Depot-Handling System is the delivery of goods to the depot. For each delivery the system should "remember" the date of the delivery, who received the goods, what goods were delivered and how many there are of each kind.

Each term is typically described as a noun, with a definition. Terms should be in the singular, "order" and "task", not "orders" and "tasks." All interested parties should agree on definitions for the terms.

Evaluate Your Results

You should check the glossary at this stage to verify that your work is headed in the right direction. There is no need to review it in detail. See especially checkpoints for the Glossary in Activity: Review Requirements.

Rational Unified Process