Header Image

Effizient arbeiten mit Architecture Decision Records (ADR)

Johannes Dienst

Johannes Dienst | DevOps Engineer | DB Systel GmbH

Dokumentation gehört nicht zu den Lieblingsaufgaben im Softwareentwicklungsalltag. Entweder es wird kaum dokumentiert oder zu viel. Dadurch wird es schwer Informationen zu finden.

Ein leichtgewichtiger Ansatz ist das arc42 Template. Dort werden auch Entwurfsentscheidungen dokumentiert, die die Softwarearchitektur prägen. Nicht dokumentierte Entwurfsentscheidungen können zu fehlerhaften Folgeentscheidungen führen, die das Projekt zum Scheitern bringen können. Doch wie können viele Entscheidungen effizient und nachvollziehbar dokumentiert werden?

In diesem Vortrag wird ein kompaktes Format namens Architecture Decision Records vorgestellt und gezeigt, wie sie effizient eingesetzt werden können. Neben Kleinigkeiten wie der Titelvergabe wird ein Lösungsvorschlag aufgezeigt, um mit einer großen Sammlung von Entwurfsentscheidungen (>50) umzugehen. Dabei kommt der Docs As Code Ansatz zum Einsatz. Durch Tagging und eine effiziente Suche, wird die Dokumentation zum täglichen Arbeitsmittel.


Johannes Dienst ist Softwarecrafter aus Leidenschaft bei der DB Systel GmbH. Sein Tätigkeitsschwerpunkt liegt im Bereich Content Management, DevOps und Softwarequalität. Durch intensive Nutzung von ADRs in der täglichen Arbeit, kann er viele Beispiele aus der Praxis anbringen.

April 20 @ 09:15
09:15 — 10:00 (45′)

Mehr erfahren