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 ?