What do you think?
Rate this book
Softwarearchitekturen dokumentieren und kommunizieren: Entwürfe, Entscheidungen und Lösungen nachvollziehbar und wirkungsvoll festhalten
277 pages, Hardcover
First published May 1, 2012
2 people are currently reading
21 people want to read
Ratings & Reviews
Friends & Following
Create a free account to discover what your friends think of this book!
Community Reviews
Displaying 1 - 2 of 2 reviews
January 5, 2023
--- bezieht sich auf die 3. Auflage von Ende 2022 ---
Ein umfängliches Buch zur Dokumentation in Software-Entwicklungsprojekten.
Anhand eines eigens ausgearbeiteten Java-Projekts als "durchgängiges Beispiel" (ein Schachprogramm mit Benutzeroberfläche) erarbeitet der Autor methodisch (und sehr gründlich) die für ein solches Projekt erforderliche und erwartbare Dokumentation und bewegt sich dabei weitgehend nah an der bekannten (Open Source-)Dokumentationsvorlage [arc42](https://www.arc42.de/overview/).
Mit dem Schwerpunkt auf "Architekturdokumentation" meint der Autor offenbar i.W. Software-Architekturen mit einem Schwerpunkt auf Eigenentwicklungen (mit JAVA o.ä.) im mittelständischen Bereich.
Im Weiteren werden die in diesem Umfeld gebräuchlichen Mittel aus dem agilen Entwicklungsumfeld, wie UML, Wikis, Doc-as-Code etc. eingebracht.
Im Abschluß ist die vollständige Dokumentation des "durchgängigen Beispielprojekts", wohl als Referenz, ausgedruckt angefügt.
Zusammenfassend:
Mit der Fokussierung auf (objektorientierte) Software-Entwicklungsprojekte und mehr oder weniger strikt damit assoziierte Werkzeuge und Methoden bleibt das Buch ein wenig hinter meinen Erwartungen (und dem Anspruch des Titels) zurück. Die Dokumentation von Enterprise-Architekturen und IT-Infrastrukturen jenseits des OO-Programmierumfelds ist lückenhaft.
Das Buch ist als vollständiges Nachschlagewerk für Softwareentwickler angelegt, die ihre eigene Arbeit im Team dokumentieren wollen. Mit einer anderen Ausrichtung - ein Blick über den Tellerrand der reinen OO-Softwareentwicklung, die Verlagerung von allgemein bereits anderso Gesagtem mit sekundären Referenzen zum Nachschlagen, und damit eine Kürzung auf ein Narrativ von Zusammenhängen und neuen Einsichten - hätte ein Buch gelingen können, das mit weniger mehr erreicht hätte.
Ein umfängliches Buch zur Dokumentation in Software-Entwicklungsprojekten.
Anhand eines eigens ausgearbeiteten Java-Projekts als "durchgängiges Beispiel" (ein Schachprogramm mit Benutzeroberfläche) erarbeitet der Autor methodisch (und sehr gründlich) die für ein solches Projekt erforderliche und erwartbare Dokumentation und bewegt sich dabei weitgehend nah an der bekannten (Open Source-)Dokumentationsvorlage [arc42](https://www.arc42.de/overview/).
Mit dem Schwerpunkt auf "Architekturdokumentation" meint der Autor offenbar i.W. Software-Architekturen mit einem Schwerpunkt auf Eigenentwicklungen (mit JAVA o.ä.) im mittelständischen Bereich.
Im Weiteren werden die in diesem Umfeld gebräuchlichen Mittel aus dem agilen Entwicklungsumfeld, wie UML, Wikis, Doc-as-Code etc. eingebracht.
Im Abschluß ist die vollständige Dokumentation des "durchgängigen Beispielprojekts", wohl als Referenz, ausgedruckt angefügt.
Zusammenfassend:
Mit der Fokussierung auf (objektorientierte) Software-Entwicklungsprojekte und mehr oder weniger strikt damit assoziierte Werkzeuge und Methoden bleibt das Buch ein wenig hinter meinen Erwartungen (und dem Anspruch des Titels) zurück. Die Dokumentation von Enterprise-Architekturen und IT-Infrastrukturen jenseits des OO-Programmierumfelds ist lückenhaft.
Das Buch ist als vollständiges Nachschlagewerk für Softwareentwickler angelegt, die ihre eigene Arbeit im Team dokumentieren wollen. Mit einer anderen Ausrichtung - ein Blick über den Tellerrand der reinen OO-Softwareentwicklung, die Verlagerung von allgemein bereits anderso Gesagtem mit sekundären Referenzen zum Nachschlagen, und damit eine Kürzung auf ein Narrativ von Zusammenhängen und neuen Einsichten - hätte ein Buch gelingen können, das mit weniger mehr erreicht hätte.
Read
December 25, 2013Sehr gutes Buch und für die Projektbegleitung geeignet
Displaying 1 - 2 of 2 reviews