Describing and Documenting Your Architecture

Originally aired:

About the Session

You’ve created an architecture and have plenty of diagrams to illustrate your solution. Now, you need to communicate that architectural solution to various stakeholders—developers, other architects, product owners, business stakeholders, and operations teams. How do you effectively convey your architectural solution? It turns out that diagrams are only a small part of the overall picture. In this session, Mark Richards introduces the concept of an Architecture Narrative—a way of effectively describing your solution—and shows you how to create one.

Target Audience: This session is primarily aimed at Software Architects, as it focuses on effectively documenting and communicating architectural decisions to various stakeholders, a critical part of their role. Product Owners and Business Stakeholders are the secondary audience, as they need to understand the architecture in a way that aligns with business goals and operational requirements.

See Highlights

Hear What Attendees Say

PwC

“Once again Saltmarch has knocked it out of the park with interesting speakers, engaging content and challenging ideas. No jetlag fog at all, which counts for how interesting the whole thing was."

Cybersecurity Lead, PwC

Intuit

“Very much looking forward to next year. I will be keeping my eye out for the date so I can make sure I lock it in my calendar."

Software Engineering Specialist, Intuit

GroupOn

“Best conference I have ever been to with lots of insights and information on next generation technologies and those that are the need of the hour."

Software Architect, GroupOn

Hear What Speakers & Sponsors Say

Scott Davis

“Happy to meet everyone who came from near and far. Glad to know you've discovered some great lessons here, and glad you joined us for all the discoveries great and small."

Web Architect & Principal Engineer, Scott Davis

Dr. Venkat Subramaniam

“Wonderful set of conferences, well organized, fantastic speakers, and an amazingly interactive set of audience. Thanks for having me at the events!"

Founder of Agile Developer Inc., Dr. Venkat Subramaniam

Oracle Corp.

“What a buzz! The events have been instrumental in bringing the whole software community together. There has been something for everyone from developers to architects to business to vendors. Thanks everyone!"

Voltaire Yap, Global Events Manager, Oracle Corp.