Have You Gone MADR? - Markdown Any Decision Records

Discover the power of MADR (Markdown Any Decision Records) in this 16-minute Devoxx talk by Johan Hutting. Learn how to solve the common challenge of remembering past decisions and their alternatives instead of relying on scattered code comments, wikis, and private documents. Explore how MADR offers structure for documenting decisions and examine practical examples of applying this approach in team and project settings. The talk emphasizes that MADR isn't limited to architectural decisions and highlights how it can be combined with Markdown in JavaDoc (available from Java 23) to create a unified technical documentation system. By the end of this session, gain clear insights on whether MADR and Markdown can help your team efficiently review past decisions, and learn practical steps for implementation.