We all know the challenge of remembering why a certain decision was made and why we decided not to go for a specific alternative.
This is usually solved by code comments, keeping notes on wiki's, private docs on laptops and so on. What if I told you there is an interesting alternative called MADR: Markdown Any Decision Records?
In this talk we won't just learn what MADR offers in structuring and reading up decisions from the past, but we'll also look at some examples on how to apply this in a team and project. This is not just restricted to architectural decisions! Along with the new MarkDown in JavaDoc available from Java 23 and beyond this will offer a single way to cover your technical documentation.
After this session you should have a clear indication if MADR and MarkDown will help you and your team as well as future teammates efficiently review decisions from the past, and how to get started when it does.
This is usually solved by code comments, keeping notes on wiki's, private docs on laptops and so on. What if I told you there is an interesting alternative called MADR: Markdown Any Decision Records?
In this talk we won't just learn what MADR offers in structuring and reading up decisions from the past, but we'll also look at some examples on how to apply this in a team and project. This is not just restricted to architectural decisions! Along with the new MarkDown in JavaDoc available from Java 23 and beyond this will offer a single way to cover your technical documentation.
After this session you should have a clear indication if MADR and MarkDown will help you and your team as well as future teammates efficiently review decisions from the past, and how to get started when it does.
Johan Hutting
ING
Developer advocate with more than 15 years of experience designing, developing and maintaining Android, Java SE/EE and Spring applications. Strong focus on getting things done with the Agile mindset. Love to share knowledge on the latest Java language, EE and Spring improvements by giving workshops and talks as well as participating in them.