# Machines, Code, People

> Eine Zühlke-Anthologie mit 50 kurzen Beiträgen. Romano Roth hat das Kapitel über das Dokumentieren von Architekturentscheidungen beigesteuert.

- Date: 2019-06-18
- Source: https://romanoroth.com/de/books/machines-code-people/
- Tags: Architekturentscheidungen, Dokumentation, Software Engineering


Eine Anthologie von Zühlke: 50 kurze Beiträge, einer pro Ingenieurin oder Ingenieur, über das, was der jeweiligen Person am meisten am Herzen liegt.

Meiner heisst *CYA: Cover your ass* und handelt vom Dokumentieren von Architekturentscheidungen. Nicht das 200-seitige Dokument, das niemand liest. Die kurze Notiz darüber, was entschieden wurde, welche Alternativen es gab und warum eine davon gewonnen hat, geschrieben im Moment der Entscheidung und billig genug, dass sie tatsächlich geschrieben wird.

Sieben Jahre später ist das immer noch die Praxis, die ich zuerst empfehle, wenn ein Team mir erzählt, dass es dieselben Fragen immer wieder neu diskutiert.