A pragmatic approach to the challenge of building more effective software requirements.
° New content, new theme, new subtitle! The use case approach is a cornerstone technique, and a more prescriptive approach is employed
° Proven "team skills" exercises help the reader roll the requirements process out to the reast of the team
° Foreword by Ed Yourdon
"Many projects fail because developers fail to build the right thing. Developers of any kind of application should read this book." —Grady Booch
"A comprehensive solution to the requirements challenges faced by every development team. Full of insight and ideas all developers can learn from." —Ivar Jacobson
Despite the wealth of development knowledge, experience, and tools available today, a substantial percentage of software projects fail, often because requirements are not correctly determined and defined at the outset, or are not managed correctly as the project unfolds. This second edition of the popular text Managing Software Requirements focuses on this critical cause of failure and offers a practical, proven approach to building systems that meet customers' needs on time and within budget.
Using an accessible style, their own war stories, and a comprehensive case study, the authors show how analysts and developers can effectively identify requirements by applying a variety of techniques, centered on the power of use cases. The book illustrates proven techniques for determining, implementing, and validating requirements. It describes six vital Team Skills for managing requirements throughout the lifecycle of a project: Analyzing the Problem, Understanding User Needs, Defining the System, Managing Scope, Refining the System Definition, and Building the Right System. Managing Software Requirements, Second Edition, specifically addresses the ongoing challenge of managing change and describes a process for assuring that project scope is successfully defined and agreed upon by all stakeholders.Topics covered include:
Preface to the Second Edition.
Preface to the First Edition.
1. The Requirements Problem.
The Goal of Software Development.
A Look at the Data.
The Root Causes of Project Success and Failure.
The Frequency of Requirements Errors.
The High Cost of Requirements Errors.
What Is a Software Requirement?
What Is Requirements Management?
Application of Requirements Management Techniques.
Types of Software Applications.
The Road Map.
The Problem Domain.
Moving Toward the Solution Domain.
Features of the System.
Traditional Software Process Models.
The Waterfall Model.
The Spiral Model.
The Iterative Approach.
Requirements in the Iterative Model.
Software Development as a Team Activity.
Requisite Team Skills for Effective Requirements Management.
Team Members Have Different Skills.
The Organization of Software Teams.
The Case Study.
Background for the Case Study.
The HOLIS Software Development Team.
Team Skill 1 Analyzing the Problem.
Step 1: Gain Agreement on the Problem Definition.
The Problem Statement.
Step 2: Understand the Root Causes-The Problem Behind the Problem.
Addressing the Root Cause 48
Step 3: Identify the Stakeholders and the Users.
Step 4: Define the Solution System Boundary.
Step 5: Identify the Constraints to Be Imposed on the Solution.
The Purpose of Business Modeling.
Using Software Engineering Techniques for Business Modeling.
Choosing the Right Technique.
The Unified Modeling Language.
Business Modeling Using UML Concepts.
From the Business Model to the Systems Model.
When to Use Business Modeling.
What Is Systems Engineering?
Pragmatic Principles of Systems Engineering.
The Composition and Decomposition of Complex Systems.
Requirements Allocation in Systems Engineering.
On Derived Requirements.
A Quiet Revolution.
When Generations Collide: Graying Baby Boomer Meets Generation X-er.
Avoiding the Stovepipe System Problem.
When Subsystems Are Subcontracts.
Addressing the Conundrum.
The Case Study: Systems Engineering for HOLIS.
Preliminary User Needs.
HOLIS: The System, Actors, and Stakeholders.
HOLIS Systems Engineering.
The Subsystems of HOLIS.
Team Skill 1 Summary.
Team Skill 2 Understanding User and Stakeholder Needs.
Barriers to Elicitation.
The "Yes, But" Syndrome.
The "Undiscovered Ruins" Syndrome.
The "User and the Developer" Syndrome.
Stakeholder and User Needs.
Managing Complexity by Picking the Level of Abstraction.
Attributes of Product Features.
The Moment of Truth: The Interview.
Compiling the Needs Data.
The Analyst's Summary: 10 + 10 + 10 pi 30.
The Case Study.
A Note on Questionnaires.
Accelerating the Decision Process.
Preparing for the Workshop.
Selling the Concept.
Ensuring the Participation of the Right Stakeholders.
Attending to Logistics.
Providing Warm-Up Materials.
Choosing the Facilitator.
Setting the Agenda.
Running the Workshop.
Problems and Tricks of the Trade.
Brainstorming and Idea Reduction.
Production and Follow-Up.
The Case Study: The HOLIS Requirements Workshop.
The Analysis of Results.
Types of Storyboards.
What Storyboards Do.
Tools for Storyboarding.
Tips for Storyboarding.
Team Skill 2 Summary.
Team Skill 3 Defining the System.
The Benefits of Use Cases.
Use Case Basics.
Use Case Anatomy.
A Step-by-Step Guide to Building the Use-Case Model.
Step 1: Identify and Describe the Actors.
Step 2: Identify the Use Cases and Write a Brief Description.
Step 3: Identify the Actor and Use-Case Relationships.
Step 4: Outline the Individual Use Cases.
Step 5: Refine the Use Cases.
On Use Cases, Storyboarding, and User Interface Design.
Use Cases and User Interfaces.
Use Cases and Storyboarding.
A Use Case Storyboard Example.
The Case Study: The HOLIS Use Cases.
Find the HOLIS Actors.
Find the HOLIS Use Cases.
Associate the Actors and Use Cases.
Outline the Use Cases.
Organizing Requirements of Complex Hardware and Software Systems.
Organizing Requirements for Product Families.
On "Future" Requirements.
The Case Study: Organizing the HOLIS Requirements.
Components of the Vision Document.
The Delta Vision Document.
The Vision Document for Version 1.0.
The Vision Document for Version 2.0.
The Delta Vision Document in a Legacy System Environment.
The Role of the Product Champion.
The Product Manager in a Software Product Company.
Primary Activities for a Product Manager.
Driving the Vision.
Maintaining the Product Road Map.
Defining the Whole Product Plan.
Sponsoring the Use-Case Model and Supplementary Requirements.
Testing the Product Concept.
Completing the User Experience.
Defining Commercial Terms.
Positioning and Messaging.
Branding and Product Labeling.
End User Training Materials.
Sales and Marketing Collateral.
The Product Champion in an IS/IT Shop.
Team Skill 3 Summary.
Team Skill 4 Managing Scope.
The Problem of Project Scope.
The Hard Question.
The Requirements Baseline.
Adding the Risk Element.
A Reasonable First Estimate.
The Case Study: Scope Management for HOLIS.
Engaging Customers to Manage Their Project Scope.
Communicating the Result.
Negotiating with the Customer.
Managing the Baseline.
Team Skill 4 Summary.
Team Skill 5 Refining the System Definition.
Looking Deeper into Software Requirements.
The Relationship between Software Requirements and Use Cases.
The Relationship between Features and Software Requirements.
The Requirements Dilemma: What versus How.
Excluding Project Information.
Excluding Design Information.
More on Requirements versus Design.
Iterating Requirements and Design.
A Further Characterization of Requirements.
Functional Software Requirements.
Nonfunctional Software Requirements.
How Use Cases Evolve.
The Scope of a Use Case.
The Case Study: Anatomy of a Simple Use Case.
Reviewing the Actors.
Reviewing the Name.
Refining the Description.
Defining and Refining the Flow of Events.
Identifying the Pre- and Post-conditions.
Identifying Special Requirements.
Summary of Our Refined Use Case.
Extending Use Cases.
Including Use Cases in Other Use Cases.
The Role of the Supplementary Specification.
Expressing Functional Requirements in the Supplementary Specification.
Exploring Nonfunctional Requirements.
Understanding Design Constraints.
Sources of Design Constraints.
Handling Design Constraints.
Are Design Constraints True Requirements?
Identifying Other Requirements.
Linking the Supplementary Specification to the Use Cases.
Template for the Supplementary Specification.
Finding the "Sweet Spot".
Mary Had a Little Lamb.
Techniques for Disambiguation.
Finite State Machines.
Decision Tables and Decision Trees.
Team Skill 5 Summary.
Team Skill 6 Building the Right System.
Mapping Requirements Directly to Design and Code.
The Orthogonality Problem.
The Use Case as a Requirement.
Managing the Transition.
Modeling Software Systems.
The Architecture of Software Systems.
The Role of the Use-Case Model in Architecture.
Realizing Use Cases in the Design Model.
Structural and Behavioral Aspects of Collaborations.
Using Collaborations to Realize Sets of Individual Requirements.
From Design to Implementation.
A Tester's Perspective: Musings on the Big Black Box.
Is a Use Case a Test Case?
Common Testing Terms.
Relationships of Test Artifacts.
The Role of the Test Cases.
Deriving Test Cases from Use Cases: A Four-Step Process.
Step 1: Identify the Use-Case Scenarios.
Step 2: Identify the Test Cases.
Step 3: Identify the Test Conditions.
Step 4: Add Data Values to Complete the Test Case.
Managing Test Coverage.
Black-Box versus White-Box Testing with Use Cases.
The Role of Traceability in Systems Development.
The Traceability Relationship.
A Generalized Traceability Model.
Tracing Requirements in the System Definition Domain.
Tracing Requirements to Implementation.
Tracing from Requirements to Testing.
Using Traceability Tools.
Proceeding without Traceability Tools.
Why Do Requirements Change?
°We Have Met the Enemy, and They Is Us°.
A Process for Managing Change.
Step 1: Recognize That Change Is Inevitable, and Plan for It.
Step 2: Baseline the Requirements.
Step 3: Establish a Single Channel to Control Change.
Step 4: Use a Change Control System to Capture Changes.
Step 5: Manage Change Hierarchically.
Requirements Configuration Management.
Tool-Based Support for Change Management.
Elements Impacted by Change.
Audit Trail of Change History.
Configuration Management and Change Management.
Software Project Quality.
Assessing Quality in Iterative Development.
Requirements Artifacts Sets.
Performing the Assessment.
Quality Assessment Checklists for Requirements.
Team Skill 6 Summary.
What You've Learned So Far.
Team Skill 1: Analyzing the Problem.
Team Skill 2: Understanding User and Stakeholder Needs.
Team Skill 3: Defining the System.
Team Skill 4: Managing Scope.
Team Skill 5: Refining the System Definition.
Team Skill 6: Building the Right System.
Mitigating Requirements Risk with Effective Requirements Practices.
Methodology Design Goals.
Documentation Is a Means to an End.
An Extreme Requirements Method.
An Agile Requirements Method.
A Robust Requirements Method.
Selecting Your Requirements Approach.
The Simplifying Assumptions.
On to the Next Release!