Dokumentation zählt generell nicht zu den Lieblingsbeschäftigungen eines Entwicklers. Speziell die Architektur einer Softwarelösung ist in vielen Fällen nicht angemessen dokumentiert. Wichtige Fragen, die sich der Leser stellt, werden nicht beantwortet, oder die Dokumentation ist zwar umfangreich, aber (auch deshalb?) mit der Zeit veraltet – sie gibt nicht mehr den aktuellen Stand wieder und ist damit nutzlos geworden. Diese Kolumne soll Anregungen geben, wie Architekturen angemessen dokumentiert werden können. Wie kann eine Dokumentation aufgebaut und gepflegt werden? Welche Arbeitsergebnisse und Werkzeuge haben sich in der Praxis bewährt? Dabei soll auch die Agilität im Blick behalten werden. Wie viel Dokumentation hilft wem weiter?