Introduction

Diagrams are a key part of architectural work. Diagrams communicate ideas to many different kinds of stakeholders, with many different needs. Diagrams help delivery teams stay aligned, by serving as a single source of truth about the realities of implementations and products. Diagrams are also critical to empowering business stakeholders to make the right purchasing and technology choices. Unfortunately, a single diagram typically cannot convey meaning to every possible stakeholder.

We developed this guidance to empower everyone to build accurate and understandable Salesforce diagrams. The resources provided here and in the links below will help you get started building your own diagrams with a predictable, standardized look and feel.

Diagram Styles

Most diagrams only convey meaning to a specific set of stakeholders, for a specific purpose.

It can be difficult to know what type of diagram best supports a given scenario, what kinds of data can and can't be shown in various diagrams, or what kinds of diagrams best communicate with different stakeholders.

We categorize diagrams into two general styles, based on purpose and intended audience. Clarifying the intent of the diagram you're trying to create is a critical first step in creating something that will resonate with your intended audience. Below, you'll see an overview of the two styles for Salesforce diagrams: Documentation & Implementation, and Marketing, Strategy & Sales.

Marketing, Strategy & Sales

Purpose: Help viewers understand concepts or a vision for a solution.
Audience: Business & Executive Stakeholders, Technical Influencers

Marketing, Strategy, and Sales style diagram purpose and audience

Documentation & Implementation

Purpose: Help viewers understand an implementation or product-related technical detail.
Audience: Delivery Teams, Technical Stakeholders

Documentation and Implementation style diagram purpose and audience

Diagram Levels

Being clear about the intentions and audience for your diagram is an important first step. After that, you have to decide what kinds of details best support your purpose. This is where diagram levels come into play. We use a concept of 'levels' to help separate different kinds of details into easy to choose categories.

Selecting the right level for your diagram helps you communicate with the right amount of detail, which means even highly complex diagrams can still be easy for a viewer to understand.

Diagram depicting diagram levels

As you move from Level 1 → Level 4 you zoom into greater levels of detail, finer granularity, and reduced surface area or scope. Below, we look at what these levels mean for each diagram style.

The concept of using levels to convey different kinds of detail is common to many frameworks, including the C4 model which is used to visualize software architectures.

Marketing, Strategy & Sales

For example templates, see Marketing, Strategy, & Sales Templates

Key Characteristics Marketing, Strategy & Sales Diagram Levels
Level 1: The Big Picture Level 2: Piece of the Whole Level 3: Process or Interaction View Level 4: The Double Click
Scope “Art of the possible", Digital transformation scenarios A single business capability solution overview A business process in support of a single capability Fine-grained detail about a single process
Audience Business and executive stakeholders, technical influencers Business and executive stakeholders, some technical stakeholders (i.e. architects), some delivery team members (i.e. delivery lead, admins) Some business stakeholders (i.e. product owners), some technical stakeholders (i.e. architects), delivery team members (i.e. lead, admins, devs) Some business stakeholders (i.e. product owners), technical stakeholders, delivery team members
Elements Business capabilities and high-level product positioning Specific technology or product subset, illustrating a single business capability and supporting relationships Personas, input channels, timing, and some finer details about relationships Personas, input channels, timing, and the finest-grain details about relationships (i.e. data flow, visibility & access)
Example Diagram Use Cases Marketecture, Business Capability Map, Blueprint, Value Map Solution architecture Business process, process flow, user journey A step or portion of a business process, process flow, data flow, user journey

Documentation & Implementation

For example templates, see Documentation and Implementation Diagram Templates

Key Characteristics Documentation & Implementation Diagram Levels
Level 1: The Big Picture Level 2: Piece of the Whole Level 3: Process or Interaction View Level 4: The Double Click
Scope System landscape or solution overview A subset of a system landscape or solution Limited view of products or technologies in a solution, focused on showing more complex detail Most narrow view, focused on showing fine-grained details
Audience Business and executive stakeholders, technical stakeholders, delivery teams Some business and executive stakeholders (example: a product owner), technical stakeholders, delivery teams Technical stakeholders, delivery teams Technical stakeholders, delivery teams
Elements Actual products or technologies in a specific implementation Actual products or technologies involved in specific pieces of functionality, services, interfaces Time-based interactions or data flows, or system interactions required to support a process Fine-grained technical specifications or requirements
Example Diagram Use Cases System Landscape Integration Layer Authentication Flow Data Model (ERD/UML)

Learn More