Diagrams are an essential tool and a key part of architectural work. They enable us to communicate many different ideas to many different kinds of stakeholders.
Diagrams help delivery teams stay aligned, by serving as a single source of truth about the realities of implementations and products. Diagrams are also a critical way to empower business stakeholders to make the right purchasing and technology decisions.
Diagrams should always:
The scope of a diagram should be limited to only the critical information to convey for a specific topic. Anything that is not required to capture the message you intend to communicate should be excluded. Multiple diagrams can (and should) be created to capture varying concepts, in order to more clearly communicate and narrow the focus of diagram content.
Salesforce Diagrams has defined our most useful/popular types of diagrams in order to help you easily utilize templates and understand diagramming conventions. Our current resources are classified as:
✨ Find Capability Maps in the Reference Architecture Gallery
✨ Find System Landscape examples & templates in the Reference Architecture Gallery
✨ Find Solution Architecture examples & templates in the Reference Architecture Gallery
✨ Find examples & templates of Interaction, Process, and Flow diagrams in the Reference Architecture Gallery
✨ Find Data Model examples & templates in the Data Model Gallery
See examples of the Diagram Types in the Reference Architecture Gallery or our dedicated Data Model Gallery. Utilize a template to quickly/easily create a diagram for your use case.
Define the scope of the message you need to convey:
Ensure there is a Header with a clear Title and a concise, thoughtfully-worded Description that captures the purpose, scope and message of your diagram
Utilize Cards to capture the properties (systems, concepts, entities, etc.)
Capture property details or key aspects / capabilities as needed in Card Attributes
See the Standard Components page for more details and best practices.
Have Salesforce Diagrams input or questions? Please let us know your thoughts here.