Artifact Common Applications Common Misapplications Iterate To

advertisement
Artifact
Common
Applications
Common
Misapplications
Iterate To
Suggested
Media
When to Keep
It
Likely
Alternate/Similar Also Known
Value as
References
Artifact
As
Keeper
Class
diagram
Essential use
case
Activity
Diagram (UML)
Organization
chart
Analysis or
design of a
business process
or business rule
Source code
-
Design of the
logic flow of a
complex
operation
System use
case
Usage
scenario
Data flow
diagram
Handdrawn
sketch
Drawing
tool
To provide a
high-level
overview of the Low
logic for a
business process
Flow chart
Specification
-
language
CASE tool
Workflow
diagram
Use case
diagram
User story
UML Activity
diagram style
guidelines
Activity
diagram
Collaboration
diagram
Component
diagram
Conceptual
modeling
Class Diagram
(UML)
Physical database
modeling
Domain model
Domain modeling
documentation for
users
Exploration of the
structure of
Only design
object-oriented
diagram for OO
software
software
CRC model
Data model
Sequence
diagram
Handdrawn
sketch
CASE tool
You need to
communicate the
internal structure Low
of your software
to others.
Class
Responsibility
Collaborator
(CRC) Model
Object model
Source code
State chart
diagram
Usage
scenario
User story
UML Class diagram
style guidelines
Business rule
Change case
Constraint
Class
diagram
Domain modeling
Class
Responsibility
Collaborator
(CRC) Model
Essential use
case
Conceptual
modeling
Exploration of the
design of the
structure of
object-oriented
software
-
Organization
chart
Index card
Typically
discarded after
use.
Very
Low
CRC cards
Class diagram
Index cards
System use
case
Usage
scenario
C2 Wiki Web
Description of CRC
Use case
diagram
Cards
User story
Class
diagram
Exploration of the
Communication dynamic nature of
Diagram (UML) complex object
interactions
Component
diagram
Deployment
diagram
Handdrawn
sketch
CASE tool
Typically
discarded after
use
Very
May be kept to Low
show design of a
complex portion
of software
Sequence Diagram
Interaction
diagram
Robustness
diagram
Source code
System use
case
Usage
scenario
User interface
flow diagram
User interface
prototype
User story
UML Communication
diagram style
guidelines
Logical business
architecture
modeling
Component
Diagram (UML) Physical
architectural
modeling of a
component-based
software system
Class
diagram
Deployment
diagram
Sequence
diagram
Handdrawn
sketch
CASE tool
Often kept to
depict high-level High
architecture
-
-
UML Component
diagram style
guidelines
Change case
Data Flow
Diagram (DFD)
Over specification Constraint
of a system by
Analysis of
"drilling down" into
existing business
Data model
sub processes with
processes
more DFDs.
Deployment
Design of new or
diagram
Significant effort to
updated business
level balance
processes
between a DFD and Organization
chart
its sub-DFDs
Structure
Handdrawn
sketch
Drawing
tool
CASE tool
To communicate
overall design of
Low
a processintensive system
Activity diagram
Workflow diagram
Process
model
diagram
System Use
case
Usage
scenario
Use case
diagram
User story
Workflow
diagram
Class diagram
Conceptual
Physical database modeling of OO
software
design
Data Model
Domain modeling
Conceptual or
domain modeling for OO software
for a data
warehouse
Exploration of
structure of OO
software
Explore
relationships
between a handful A primary driver of
of entities
the structure of a
Class diagram
Data flow
diagram
Deployment
diagram
Source code
System use
case
Usage
scenario
User story
To document
physical
database design
Handdrawn
sketch
CASE tool
As a contract
Very
model between High
the database
owners and other
systems
accessing the
database
Persistence
Model
-
EntityRelationship
Diagram
Workflow
diagram
Data Modeling 101:
An Agile Data Article
A UML Profile for
Data Modeling
The Process of
Database Refactoring
Catalog of Database
Refactorings
Change case
Constraint
Essential Use
Case
Identification of
usage
requirements for a
system
Identification of
enterprise-level
requirements for
an organization
Essential user
interface flow
prototype
Word
processor
Robustness
CASE tool
diagram
Part of official
requirements
documentation
for a system
Usage scenario
Medium
User Story
Business use
case
System use
case
Technical
requirement
Business rule
Constraint
Essential User
Interface
Prototype
Exploration of the
requirements for
the user interface
of a system
Essential use
case
Paper
(including
Post-It
notes)
User interface Handflow diagram drawn
sketch
User interface
prototype
Typically
discarded
Very
Low
Abstract
prototype
Low-Fidelity
Prototype
Data flow
diagram
External
Interface
Specification
(Contract
Model)
Definition of
interface (via an
API, data feed, ...) ?
to an external
system
Data model
Deployment
diagram
Word
processor
CASE tool
As a contract
model between Very
your system and High
an external one
?
Workflow
diagram
Class
diagram
Flow Chart
Definition of
complex logic
Collaboration
diagram
Handdrawn
Over specification
sketch
Sequence
of logic when
diagram
source code or
specification
Drawing
language would do System use
tool
just as well
case
CASE tool
Usage
scenario
User story
Activity diagram
Typically
discarded
Low
Specification
language
-
Class
diagram
Data model
Glossary
Definition of
common terms
To much focus on
getting it perfect.
System use
case
Word
processor
Official
definitions of
terms.
Medium -
Definitions
Usage
scneario
Component
diagram
Analysis of
existing technical
infrastructure
Network
Diagram
Object Role
Model (ORM)
Diagram
Design of
proposed
technical
infrastructure
Exploring domain
concepts with
stakeholders
Conceptual
modeling
-
System use
case
Workflow
diagram
Handdrawn
sketch
Drawing
tool
Official
description of
technical
High
infrastructure for
your system or
organization
Deployment
diagram
Technical
Architecture
Diagram
CASE tool
CRC model
Data model
-
UML Class
diagram
Handdrawn
sketch
Official
conceptual
model for your
system
Low
Data model
UML Class
Diagram
www.orm.net
Object Role Model
(ORM) Diagram
Overview
High-level
overview diagram
that depicts the
logical
organization of
requirements or a
domain model
High-level
overview diagram
Package
depicting the
Diagram (UML)
physical
organization of
classes into
packages
To organize
work, such as the
assignment of
requirements to
specific subteams
Class
diagram
Use case
diagram
When a CASE
tool diagram is
CASE tool used to generate
code into
specific
Index cards packages
Handdrawn
sketch
As an overview
diagram
depicting the
organization of
requirements
Medium
Component
diagram
Logical
Package
Diagram
Robert Martin's
Papers on
Granularity, Stability,
and OO Quality
Metrics.
Kirk Knoernschild's
papers on package
dependency and the
Acyclic Dependency
principle.
Package diagram style
guidelines
Class
diagram
Modeling the
logic of a usage
scenario or a path
Sequence
though one or
Diagram (UML)
more use cases
(or part(s)
thereof)
Robustness
Modeling of the
diagram
logic for every
single path through
System use
all the usage
case
requirements for
your system
Usage
scenario
Handdrawn
sketch
Typically
discarded
Very low
Collaboration
Diagram
Interaction
diagram
CASE tool
User story
UML Sequence
diagram style
guidelines
Business rule
State Machine
Diagram (UML)
Design the
behavior of a
complex class
State
diagram
Design the behavior Class
diagram
of several classes
Model process flow Source code
Design the behavior
Analyze a
complex business of a simple class
and/or one without
process
interesting behavior
based on state
System use
case
Handdrawn
sketch
CASE tool
May be kept as
part of your
design
documentation
for complex
class or process
Statechart
Low
-
State
transition
diagram
Usage
scenario
Petri nets
Table
UML State machine
diagram style
guidelines
Structure
Diagram
Explore the "call" Design of objecthierarchy within oriented software
Dataflow
diagram
Handdrawn
High-level
design of
Low
Collaboration
diagram
Call diagram
Jackson Structure
Diagrams
the design of
procedural
software
sketch
Source code
structured
software
Sequence diagram Structure
chart
Collaboration
diagram
Essential use
case
Flow chart
Identification of
usage requirements
Robustness
Analysis of usage for a system
diagram
requirements
The ONLY source
Sequence
High-level
design
of system
System Use Case
of
specification for a diagram
implementation
system (e.g. you
of usage
should avoid use- State chart
diagram
requirements
case driven
[INSERT TERM
HERE])
Usage
scenario
Use case
diagram
User interface
prototype
Word
processor
CASE tool
Part of your
design
documentation
for your system
Usage scenario
Low
User Story
Traditional
Use Case
Change case
Identification of
business
requirements
Technical
Requirement
Requirements
identification
Identification of
"gold plate"
requirements that
the technical staff
want to implement
Constraint
Deployment
diagram
Network
diagram
Workflow
diagram
Index card
Word
processor
Part of your
official
requirements
definition
Medium -
NonFunctional
Requirement
Shall
statement
Activity
diagram
Use Case
Diagram (UML)
Overview
diagram
indicating major
usage
requirements
Process
diagramming
Data flow
diagram
Essential use
case
Diagramming
Analysis of usage without supporting
requirements of
use cases
Organization
an existing
chart
system
System use
case
Handdrawn
sketch
Drawing
tool
CASE tool
Overview of
your usage
requirements
Medium -
-
UML Use case
diagram style
guidelines
Activity
diagram
Business rule
Constraint
Deployment
diagram
Usage Scenario
Exploration of the
?
usage of a system
Flow chart
Network
diagram
System use
case
Workflow
diagram
Index card
Word
processor
Typically
discarded
System Use Case
Very low
User Story
Use case
scenario
Essential use
case
User Interface
Flow Diagram
Robustness
diagram
Exploration of
user interface
requirements
?
High-level design
of an application's
user interface
System use
case
Handdrawn
sketch
Drawing
tool
User interface
CASE tool
prototype
Part of official
design
documentation
to provide
Medium overview of your
user interface
design
Interface
flow diagram
User
interface
navigation
diagram
User story
Business rule
Constraint
ONLY source of
system
specification
User Interface
Prototype
Detailed design of
Identification of
a user interface
user interface
requirements
?
Essential use
case
Robustness
diagram
Source code
System use
case
User interface
Handdrawn
sketch
User
interface
prototyping
tool
Typically
discarded or
evolved into
working system
Low
-
-
flow diagram
Workflow
diagram
Business rule
Change case
Constraint
Workflow
Diagram
Analysis of
existing business
process
Design of new
business process
ONLY source of
system
specification
Deployment
diagram
Handdrawn
sketch
Organization
chart
Drawing
tool
System use
case
CASE tool
?
Usage
scenario
User story
Part of your
design
documentation
describing the
supported
business
processes
Activity diagram
Medium
Dataflow diagram
Control flow
diagram
CoatsMellon
Notation
?
Download