SATURN 2017 has ended
Registration is open every day from 7:30 a.m. until the close of the day’s sessions.
Breakfast will be served starting at 6:30 a.m. for conference registrants in the Columbine Restaurant.
30-minute refreshment breaks are at 10:00 a.m. and 2:30 p.m. daily.
Lunch is 12:00-1:00 p.m. daily in the Columbine Restaurant.
Back To Schedule
Thursday, May 4 • 1:30pm - 2:00pm
Architecture Decision Records in Action

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Documenting architecture design decisions is commonly considered a good practice, but few teams take the time to write down the decisions they make. This happens for a few reasons: architecture documentation is rejected as being too heavyweight, documentation is typically out of sight and out of mind, and many developers don't know what to document. Architecture Decision Records (ADRs), a lightweight documentation approach proposed by Michael Nygard, solves these problems by recording design decisions in a simple markdown template in the same repository as the code affected by the ADR. In this talk, we will share our experiences and lessons from using ADRs over the past year while working on multiple projects for IBM Watson. By the end of this talk, you will be able to create effective ADRs, introduce them to your team, and avoid common pitfalls with the method.

See the slides.

Watch the slides.

avatar for Michael Keeling

Michael Keeling

Software Engineer, LendingHome
Michael Keeling is a software engineer at LendingHome and the author of Design It!: From Programmer to Software Architect. Prior to LendingHome, he worked at IBM on the Watson Discovery Service. Keeling has a Master of Science in Software Engineering from Carnegie Mellon University and a Bachelor of Science in Computer Science from the College of William and Mary... Read More →
avatar for Joe Runde

Joe Runde

Joe Runde is a software engineer who recently started his career at IBM. There he works on Watson while teaching about machine learning methods and learning about software design from many smarter folks. Joe has an MS in Machine Learning from Carnegie Mellon University and a BS in... Read More →

Thursday May 4, 2017 1:30pm - 2:00pm MDT
Conference Room C