Skip to content
A talk on communicating and documenting architectural decisions
Branch: master
Clone or download
Latest commit 6d3813f May 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit of new(edited) presentation Apr 4, 2019
comm-and-doc-arch-decisions.pptx
readme.md Update readme.md May 13, 2019
sketchnotes.jpg

readme.md

Communicating and Documenting Architectural Decisions

Presented by: David Ayers
Innovative Technology Professional | Passionate Lifelong Learner | Giant Nerd
Full Bio
@iamagiantnerd, iamagiantnerd@gmail.com

A talk about communicating and documenting architectural decisions (duh).

Talk Abstract

Making, documenting, and communicating architectural decisions is one of the hardest things to do, especially in this new age of "agile" architecture and two-pizza teams building and supporting their own software. This talk will go over three techniques to help solve these communication and decision making processes.

Talk Description

As technologists and technology leaders, we live in an interesting and chaotic time. The days of ivory-tower enteprise architects doling out treatises on approved technologies are over; instead we have agile, two-pizza teams building using emerging architecture techniques and the latest languages. How do we get a handle on this environment and make sure what's being done is documented and communicated out to the larger organization?

In this talk, I'll discuss three techniques that can be used to help:

  • Lightweight Architectural Decision Records
  • Technical Architecture Guilds
  • Building Reference Implementations

All of these may not be right for everyone, but taken together, they can be a powerful force to help document and communicate the decisions that your teams are already making every day.

Sketchnote

The awesome Denise Yu did this sketchnote of my talk at the #LeadDevNewYork conference, and she kindly agreed to let me save it here. Check out her art on her website: http://www.deniseyu.io/art

Badass sketch note of my talk!

Links:

The following links are referenced in the presentation:

Videos:

Lead Dev New York 4/30/2019

You can’t perform that action at this time.