SlideShare ist ein Scribd-Unternehmen logo
Pah, Architekturdokumentation ... 
darauf habe ich keine Lust! 
Matthias Bohlen 
http://mbohlen.de 
@mbohlende 
+49 170 772 8545 
Asleep at the Wheel — Foto: Aaron Jacobs
Die verwunderten Entwickler 
Eine Story aus dem 
wirklichen Leben 
Foto: GDC Europe
Ausreden: Wir haben doch schon… 
Code Tests JavaDoc 
Das ist doch bereits 
unsere Doku – wozu 
noch mehr?
Agilitäts-Missverständnis 
Wir schätzen 
"lauffähigen Code 
mehr als vollständige 
Dokumentation", 
deshalb machen wir 
keine !
wenig 
Wir haben keine Lust 
uncool langweilig dringend 
Doku ist uncool 
Das liest ja eh keiner 
Anderes ist dringender 
Fotos: woods Jiang, Felix, Hartwig HKD
Welcher Veraltet 
Nutzen? 
Zu viel 
Aufwand 
Echte Probleme 
Dokumente sind oft 
aufwändig, haben zu 
geringen Nutzen, oder 
sind veraltet. 
Fotos: José Carlos da Silva Encarnação, Matt Brown, Renee
Doch Achtung! 
Dokumentation hat 
auch echte Vorteile! 
Foto: Martin Fisch
Doku erleichtert die Einarbeitung 
neuer Teammitglieder 
Die Basics braucht 
man dann nur einmal 
zu erklären 
Foto: tapetenpics
Doku beantwortet die Frage nach dem Warum 
Warum etwas so 
gemacht wurde, steht 
meist weder im Code 
noch in den Tests. 
Foto: Anna Vignet
Doku macht Architektur nachvollziehbar 
Eine dokumentierte 
Architektur kann man 
gegen Qualitätsziele 
prüfen. 
Foto: Wm Jas
Doku hilft, Fehler zu vermeiden 
Sie wollen, dass Ihr 
System rockt. 
! 
Und, dass das auch 
so bleibt. 
Foto: Christian Kadluba
Doku unterstützt beim Entwerfen 
und beim Entwickeln 
Wenn Sie etwas klar 
aufschreiben müssen, 
fokussiert das Ihre 
Gedanken. 
Foto: Jenn Kahalau
Doku unterstützt Kommunikation im Projekt 
Am Whiteboard 
streiten und einigen, 
dann alles sauber 
aufschreiben. 
Foto: midnightcomm
Angemessene Doku macht das Team schneller 
Doku-Investment Fokus auf die Arbeit 
M. Bohlens Erfahrung aus Projekten – Alle Zahlen in Prozent der Teamkapazität
Die Lösung: Doku schrittweise angehen 
7 Schritte 
zum Doku-Erfolg 
Foto: Shannon Kringen
1. Den Doku-Kümmerer finden 
Wie in der WG: 
! 
Einer muss für 
Ordnung sorgen. 
Foto: Liza
2. Zielgruppe für Ihre Doku identifizieren 
Wer sind Ihre 
Stakeholder? 
! 
Was sagt Ihr 
Vorgehensmodell? 
! 
Welche Rollen? 
Welche Aufgaben? 
Welche Ergebnisse? 
Foto: Kevin Dooley
18 
Stakeholder und deren Anliegen 
Rolle Anliegen 
Projektleiter Technische Risiken, Arbeitsaufteilung 
Entwickler Wie ist das Gesamtsystem aufgebaut? 
Tester Wodurch wurde Qualität bereitgestellt? 
Requirements 
Analyst Wodurch sind die Anforderungen abgedeckt? 
Betrieb Was bekommen wir zur Inbetriebnahme? 
Wo sind die Überwachungs-Schnittstellen? 
© ADOK Training Grundbegriffe
3. Inhalte pro Zielgruppe festlegen 
Wer hat welche 
Belange und braucht 
deshalb welche Sicht 
auf das System? 
! 
Nicht jeder braucht 
alles zu lesen ! 
Foto: Internet Archive Book
Dokumentationsmittel 
Virtueller Produktkarton 
Systemkontext 
Qualitätsziele 
Qualitätsszenario 
Persona 
Technische Risiken 
Glossar 
Architekturentscheidung 
Bausteinsicht 
Schnittstellenbeschreibung 
Laufzeitsicht 
Verteilungssicht 
Übergreifende Konzepte 
© ADOK Training Grundbegriffe 20
Notationen 
UML-Diagramme 
ER-Diagramme 
Flussdiagramme 
Hierarchische Bäume 
Code-Beispiele 
Prosa-Texte 
Aufzählungen, Listen 
Tabellen 
! 
! 
Notation ist Form 
! 
! 
Dokumentationsmittel 
ist Aussage 
© ADOK Training Grundbegriffe 21
4. Medien zielgruppen-gerecht festlegen 
Sind die Mitglieder 
Ihrer Zielgruppe 
visuell oder auditiv 
veranlagt? 
! 
Bieten Sie entspre-chende 
Medien an! 
Foto: Frédéric BISSON
5. Die Sache im Team machen, nicht einzeln 
Jeder soll das zur 
Doku beitragen, was 
er/sie hat und was 
einen Stakeholder 
interessiert ! 
Foto: 드림포유
6. Schreiben, ablegen, compilieren 
Der kreative Prozess 
! 
Das sehen wir uns 
gleich noch etwas 
genauer an! 
Foto: Roger H. Goun
7. Verteilen und Feedback einholen 
War die Doku hilfreich 
für die Zielgruppe? 
! 
Was fehlt? 
! 
Was war zu viel? 
! 
Welche Darstellung 
wäre noch hilfreicher? 
Foto: woodleywonderworks
Der Erstellprozess für Dokumentation 
class Erstellprozess 
liest erzeugt 
Autor Leser 
schreibt in Build-Prozess liest 
Repository Dokument 
* 
Dokumentationsmittel 
extrahiert und 
aggregiert
Beispiel-Toolkette für Erstellung und Ablage 
Klartext mit Markup für 
die Texte 
UML-Werkzeug für die 
oder 
Abbildungen 
Versionsmanagement- 
System als Ablage 
Typesetting Tool für die 
Ausgabe 
Konverter für eBooks
Demo 
! 
$ ./make.sh
Ergebnis: PDF 
Kapitelnummern, 
Seitennummern, 
Inhaltsverzeichnis 
! 
Sehr gut lesbar 
! 
Souveräne 
Seitenaufteilung 
! 
Navigierbar 
Chapter 6 
Runtime View 
6.1 Code generation 
These are the main steps (Figure 6.1) when AndroMDA generates code: 
Figure 6.1: Overview of the entire code generation process 
• The core is started by the build tool. 
• The core discovers the components on the classpath and configures itself from an-dromda. 
xml. 
• A repository loads a model. 
• A template engine loads a template. 
• A template parses itself and searches for placeholders. 
• When a placeholder is found, the template evaluates the expression that is contained 
in the placeholder. It invokes a metafacade to obtain a value that is needed inside 
the expression. 
• The metafacade gets the raw model information from the PIM and transforms it into 
a platform specific information. 
• After the template has evaluated the placeholder expression, it replaces the place-holder 
by the result of the evaluation. 
14
Ergebnis: HTML 
Keine Update- 
Problematik 
! 
Für das Intranet 
immer aktuell 
! 
Gut lesbar 
! 
Navigierbar
Ergebnis: eBook 
Blättern wie im Buch 
! 
Gut lesbar 
! 
Navigierbar 
! 
Durchsuchbar 
! 
Annotierbar
Wenn Sie gute Doku auch für sich wollen… 
Dann sehen Sie sich 
mein kostenloses 
Video-Training an: 
! 
! 
! 
! 
! 
Hier ist es: 
http://bit.ly/rockt2014
Die Abkürzung zum Doku-Erfolg: 
Advanced Level Workshop 
mit Matthias Bohlen 
! 
Software-architektur 
dokumentieren 
! 
24./25. November, Köln 
Mehr Infos über diesen Workshop: 
http://mbohlen.de/adok-de/
Coaching 
nehmen 
Seminar 
besuchen 
Newsletter 
abonnieren 
Beginnen Sie jetzt! 
Newsletter, Blog, 
Artikel, Bücher, 
Podcast, Videos: 
http://mbohlen.de 
! 
Anrufen: 
+49 170 772 8545 
Fotos: Pascual López, Friends of Europe, iStockPhoto

Weitere ähnliche Inhalte

Andere mochten auch

2015-6 TBJ article re ACP and WFD
2015-6 TBJ article re ACP and WFD2015-6 TBJ article re ACP and WFD
2015-6 TBJ article re ACP and WFD
Mary Gregory
 
EECS441 Company preso - EzCoach
EECS441 Company preso - EzCoachEECS441 Company preso - EzCoach
EECS441 Company preso - EzCoach
Hay Wong
 
Irina Kovalchuk
Irina KovalchukIrina Kovalchuk
Irina Kovalchuk
Irina Kovalchuk
 
Carretillero frontal
Carretillero frontalCarretillero frontal
Carretillero frontal
ikasinfo
 
WJAX 2016: Liefern, schon vor dem Schätzen!
WJAX 2016: Liefern, schon vor dem Schätzen!WJAX 2016: Liefern, schon vor dem Schätzen!
WJAX 2016: Liefern, schon vor dem Schätzen!
Matthias Bohlen
 
Elektrotechnik
ElektrotechnikElektrotechnik
Elektrotechnik
Krystian Wieczorek
 
Modda accesorios
Modda accesoriosModda accesorios
Modda accesorios
Juan Jose Arredondo Pedraza
 
ÁNGELES DE CUATRO PATAS
ÁNGELES DE CUATRO PATASÁNGELES DE CUATRO PATAS
ÁNGELES DE CUATRO PATAS
Jorge Llosa
 
Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...
Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...
Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...Tom Sporer
 
Perros Y Personas
Perros Y PersonasPerros Y Personas
Perros Y Personas
Jorge Llosa
 
Una Foto Entre Un Millon
Una Foto Entre Un MillonUna Foto Entre Un Millon
Una Foto Entre Un Millon
Jorge Llosa
 
VENECIA
VENECIAVENECIA
VENECIA
Jorge Llosa
 
JORGE LUIS BORGES - SIGO EN PIE
JORGE LUIS BORGES - SIGO EN PIEJORGE LUIS BORGES - SIGO EN PIE
JORGE LUIS BORGES - SIGO EN PIE
Jorge Llosa
 
„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...
„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...
„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...
Landsmannschaft Vitebergia Halle im CC
 
Exp Iv 3
Exp Iv 3Exp Iv 3
LAS MEJORES IMÁGENES DE INTERNET
LAS MEJORES IMÁGENES DE INTERNETLAS MEJORES IMÁGENES DE INTERNET
LAS MEJORES IMÁGENES DE INTERNET
Jorge Llosa
 
Salvar el mundo
Salvar el mundoSalvar el mundo
Salvar el mundo
Jorge Llosa
 
Los hijos se van
Los hijos se vanLos hijos se van
Los hijos se van
Jorge Llosa
 
Clouds und Server in der beruflichen Bildung - didacta Hannover 2015
Clouds und Server in der beruflichen Bildung - didacta Hannover 2015Clouds und Server in der beruflichen Bildung - didacta Hannover 2015
Clouds und Server in der beruflichen Bildung - didacta Hannover 2015
Consulting-Institut für berufliche Bildung e.V., CIBBeV ... www.cibbev.de
 
Campeones del mundo
Campeones del mundoCampeones del mundo
Campeones del mundo
Jorge Llosa
 

Andere mochten auch (20)

2015-6 TBJ article re ACP and WFD
2015-6 TBJ article re ACP and WFD2015-6 TBJ article re ACP and WFD
2015-6 TBJ article re ACP and WFD
 
EECS441 Company preso - EzCoach
EECS441 Company preso - EzCoachEECS441 Company preso - EzCoach
EECS441 Company preso - EzCoach
 
Irina Kovalchuk
Irina KovalchukIrina Kovalchuk
Irina Kovalchuk
 
Carretillero frontal
Carretillero frontalCarretillero frontal
Carretillero frontal
 
WJAX 2016: Liefern, schon vor dem Schätzen!
WJAX 2016: Liefern, schon vor dem Schätzen!WJAX 2016: Liefern, schon vor dem Schätzen!
WJAX 2016: Liefern, schon vor dem Schätzen!
 
Elektrotechnik
ElektrotechnikElektrotechnik
Elektrotechnik
 
Modda accesorios
Modda accesoriosModda accesorios
Modda accesorios
 
ÁNGELES DE CUATRO PATAS
ÁNGELES DE CUATRO PATASÁNGELES DE CUATRO PATAS
ÁNGELES DE CUATRO PATAS
 
Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...
Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...
Bürgerschaftliches Engagement und zivilgesellschaftlicher Transfer an Hochsch...
 
Perros Y Personas
Perros Y PersonasPerros Y Personas
Perros Y Personas
 
Una Foto Entre Un Millon
Una Foto Entre Un MillonUna Foto Entre Un Millon
Una Foto Entre Un Millon
 
VENECIA
VENECIAVENECIA
VENECIA
 
JORGE LUIS BORGES - SIGO EN PIE
JORGE LUIS BORGES - SIGO EN PIEJORGE LUIS BORGES - SIGO EN PIE
JORGE LUIS BORGES - SIGO EN PIE
 
„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...
„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...
„Wütend wälzt sich einst im Bette…“ – Wissenschaftliche Erkenntnisse zum alko...
 
Exp Iv 3
Exp Iv 3Exp Iv 3
Exp Iv 3
 
LAS MEJORES IMÁGENES DE INTERNET
LAS MEJORES IMÁGENES DE INTERNETLAS MEJORES IMÁGENES DE INTERNET
LAS MEJORES IMÁGENES DE INTERNET
 
Salvar el mundo
Salvar el mundoSalvar el mundo
Salvar el mundo
 
Los hijos se van
Los hijos se vanLos hijos se van
Los hijos se van
 
Clouds und Server in der beruflichen Bildung - didacta Hannover 2015
Clouds und Server in der beruflichen Bildung - didacta Hannover 2015Clouds und Server in der beruflichen Bildung - didacta Hannover 2015
Clouds und Server in der beruflichen Bildung - didacta Hannover 2015
 
Campeones del mundo
Campeones del mundoCampeones del mundo
Campeones del mundo
 

Ähnlich wie WJAX 2014: Pah, ArchitekturDoku, darauf habe ich keine Lust!

Onno Reiners: E-Learning einfach selbst erstellen
Onno Reiners: E-Learning einfach selbst erstellenOnno Reiners: E-Learning einfach selbst erstellen
Onno Reiners: E-Learning einfach selbst erstellen
lernet
 
Stay calm & keep shipping - iOS DevCon 2013
Stay calm & keep shipping - iOS DevCon 2013Stay calm & keep shipping - iOS DevCon 2013
Stay calm & keep shipping - iOS DevCon 2013
superflomo
 
User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?
User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?
User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?
Product Owner Meetup München
 
Dokumentation in agilen Projekten - WebMontag Edition
Dokumentation in agilen Projekten - WebMontag EditionDokumentation in agilen Projekten - WebMontag Edition
Dokumentation in agilen Projekten - WebMontag Edition
Simon Krackrügge
 
Online-Events organisieren und durchführen am Beispiel Adobe Connect
Online-Events organisieren und durchführen am Beispiel Adobe ConnectOnline-Events organisieren und durchführen am Beispiel Adobe Connect
Online-Events organisieren und durchführen am Beispiel Adobe Connect
e-teaching.org
 
Online-Tutorials in a Nutshell
Online-Tutorials in a NutshellOnline-Tutorials in a Nutshell
Online-Tutorials in a Nutshellmel2627
 
Content Process Design: Teil 3
Content Process Design: Teil 3Content Process Design: Teil 3
Content Process Design: Teil 3
Michael Kurz
 
[lectures] Projekarbeit "E-Moderation" - Drehbuch
[lectures] Projekarbeit  "E-Moderation" - Drehbuch[lectures] Projekarbeit  "E-Moderation" - Drehbuch
[lectures] Projekarbeit "E-Moderation" - Drehbuch
Sandra Schön (aka Schoen)
 
Das Social Intranet der Detecon International GmbH
Das Social Intranet der Detecon International GmbHDas Social Intranet der Detecon International GmbH
Das Social Intranet der Detecon International GmbH
netmedianer GmbH
 
Infogem vortrag pohle_v1
Infogem vortrag pohle_v1Infogem vortrag pohle_v1
Infogem vortrag pohle_v1
Matthias Pohle
 
Software-Entwicklung Im Team
Software-Entwicklung Im TeamSoftware-Entwicklung Im Team
Software-Entwicklung Im Team
Stephan Schmidt
 
UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)
UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)
UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)
Marcus Haberkorn
 
FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...
FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...
FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...
Verein FM Konferenz
 
Softwerkskammer Chemnitz Special Pecha Kucha Night
Softwerkskammer Chemnitz Special Pecha Kucha NightSoftwerkskammer Chemnitz Special Pecha Kucha Night
Softwerkskammer Chemnitz Special Pecha Kucha Night
ChristinaLerch1
 
Multimediales Arbeiten 2017
Multimediales Arbeiten 2017Multimediales Arbeiten 2017
Multimediales Arbeiten 2017
Marcus Schwarze
 
Videokonferenz rki 30.03.19
Videokonferenz rki 30.03.19Videokonferenz rki 30.03.19
Videokonferenz rki 30.03.19
deutschonline
 
Dnug05 2011 twenty-one_v1.0
Dnug05 2011 twenty-one_v1.0Dnug05 2011 twenty-one_v1.0
Dnug05 2011 twenty-one_v1.0
TwentyOne AG
 
Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...
Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...
Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...
Thomas Maier
 
Professionell präsentieren mit PowerPoint
Professionell präsentieren mit PowerPointProfessionell präsentieren mit PowerPoint
Professionell präsentieren mit PowerPoint
Stefan Kontschieder
 
Mediendidaktische Konzepte bei der Erstellung von E-Learning
Mediendidaktische Konzepte bei der Erstellung von E-LearningMediendidaktische Konzepte bei der Erstellung von E-Learning
Mediendidaktische Konzepte bei der Erstellung von E-Learning
Jochen Robes
 

Ähnlich wie WJAX 2014: Pah, ArchitekturDoku, darauf habe ich keine Lust! (20)

Onno Reiners: E-Learning einfach selbst erstellen
Onno Reiners: E-Learning einfach selbst erstellenOnno Reiners: E-Learning einfach selbst erstellen
Onno Reiners: E-Learning einfach selbst erstellen
 
Stay calm & keep shipping - iOS DevCon 2013
Stay calm & keep shipping - iOS DevCon 2013Stay calm & keep shipping - iOS DevCon 2013
Stay calm & keep shipping - iOS DevCon 2013
 
User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?
User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?
User Stories: Klappt Card-Conversation-Confirmation auch aus dem Homeoffice?
 
Dokumentation in agilen Projekten - WebMontag Edition
Dokumentation in agilen Projekten - WebMontag EditionDokumentation in agilen Projekten - WebMontag Edition
Dokumentation in agilen Projekten - WebMontag Edition
 
Online-Events organisieren und durchführen am Beispiel Adobe Connect
Online-Events organisieren und durchführen am Beispiel Adobe ConnectOnline-Events organisieren und durchführen am Beispiel Adobe Connect
Online-Events organisieren und durchführen am Beispiel Adobe Connect
 
Online-Tutorials in a Nutshell
Online-Tutorials in a NutshellOnline-Tutorials in a Nutshell
Online-Tutorials in a Nutshell
 
Content Process Design: Teil 3
Content Process Design: Teil 3Content Process Design: Teil 3
Content Process Design: Teil 3
 
[lectures] Projekarbeit "E-Moderation" - Drehbuch
[lectures] Projekarbeit  "E-Moderation" - Drehbuch[lectures] Projekarbeit  "E-Moderation" - Drehbuch
[lectures] Projekarbeit "E-Moderation" - Drehbuch
 
Das Social Intranet der Detecon International GmbH
Das Social Intranet der Detecon International GmbHDas Social Intranet der Detecon International GmbH
Das Social Intranet der Detecon International GmbH
 
Infogem vortrag pohle_v1
Infogem vortrag pohle_v1Infogem vortrag pohle_v1
Infogem vortrag pohle_v1
 
Software-Entwicklung Im Team
Software-Entwicklung Im TeamSoftware-Entwicklung Im Team
Software-Entwicklung Im Team
 
UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)
UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)
UX Design - Concept Maps, Flowcharts, Specs (3. Sitzung)
 
FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...
FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...
FMK2015: Strukturierte Namensgebung als Basis für komplexe Programmierung by ...
 
Softwerkskammer Chemnitz Special Pecha Kucha Night
Softwerkskammer Chemnitz Special Pecha Kucha NightSoftwerkskammer Chemnitz Special Pecha Kucha Night
Softwerkskammer Chemnitz Special Pecha Kucha Night
 
Multimediales Arbeiten 2017
Multimediales Arbeiten 2017Multimediales Arbeiten 2017
Multimediales Arbeiten 2017
 
Videokonferenz rki 30.03.19
Videokonferenz rki 30.03.19Videokonferenz rki 30.03.19
Videokonferenz rki 30.03.19
 
Dnug05 2011 twenty-one_v1.0
Dnug05 2011 twenty-one_v1.0Dnug05 2011 twenty-one_v1.0
Dnug05 2011 twenty-one_v1.0
 
Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...
Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...
Stream die Video Plattform im Unternehmen - Vortrag von Thomas Maier auf dem ...
 
Professionell präsentieren mit PowerPoint
Professionell präsentieren mit PowerPointProfessionell präsentieren mit PowerPoint
Professionell präsentieren mit PowerPoint
 
Mediendidaktische Konzepte bei der Erstellung von E-Learning
Mediendidaktische Konzepte bei der Erstellung von E-LearningMediendidaktische Konzepte bei der Erstellung von E-Learning
Mediendidaktische Konzepte bei der Erstellung von E-Learning
 

Mehr von Matthias Bohlen

"Einmal durch" in 90 Minuten
"Einmal durch" in 90 Minuten"Einmal durch" in 90 Minuten
"Einmal durch" in 90 Minuten
Matthias Bohlen
 
TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...
TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...
TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...
Matthias Bohlen
 
Architektur = Kommunikation
Architektur = KommunikationArchitektur = Kommunikation
Architektur = Kommunikation
Matthias Bohlen
 
Softskills fördern den Projekterfolg
Softskills fördern den ProjekterfolgSoftskills fördern den Projekterfolg
Softskills fördern den Projekterfolg
Matthias Bohlen
 
Patterns effektiv einsetzen
Patterns effektiv einsetzenPatterns effektiv einsetzen
Patterns effektiv einsetzen
Matthias Bohlen
 
Warum Manager zu Designern werden müssen
Warum Manager zu Designern werden müssenWarum Manager zu Designern werden müssen
Warum Manager zu Designern werden müssen
Matthias Bohlen
 
Mehr Geld durch mehr Wert
Mehr Geld durch mehr WertMehr Geld durch mehr Wert
Mehr Geld durch mehr Wert
Matthias Bohlen
 
Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)
Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)
Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)
Matthias Bohlen
 
Not invented here – wie Teams besser zusammenarbeiten können
Not invented here – wie Teams besser zusammenarbeiten könnenNot invented here – wie Teams besser zusammenarbeiten können
Not invented here – wie Teams besser zusammenarbeiten können
Matthias Bohlen
 
Projekte richtig starten
Projekte richtig startenProjekte richtig starten
Projekte richtig starten
Matthias Bohlen
 
Medizin und Marketing – die Rolle des Softwarearchitekten heute
Medizin und Marketing – die Rolle des Softwarearchitekten heuteMedizin und Marketing – die Rolle des Softwarearchitekten heute
Medizin und Marketing – die Rolle des Softwarearchitekten heute
Matthias Bohlen
 
Gebrauchsanleitung für die Projektmatrix
Gebrauchsanleitung für die ProjektmatrixGebrauchsanleitung für die Projektmatrix
Gebrauchsanleitung für die Projektmatrix
Matthias Bohlen
 
WJAX 2014: Na klar muss alles "gestern" fertig sein
WJAX 2014: Na klar muss alles "gestern" fertig seinWJAX 2014: Na klar muss alles "gestern" fertig sein
WJAX 2014: Na klar muss alles "gestern" fertig sein
Matthias Bohlen
 
Softwarearchitektur entwerfen ohne dabei verrückt zu werden
Softwarearchitektur entwerfen ohne dabei verrückt zu werdenSoftwarearchitektur entwerfen ohne dabei verrückt zu werden
Softwarearchitektur entwerfen ohne dabei verrückt zu werden
Matthias Bohlen
 
WJAX 2012: Agile Teams im Gleichgewicht
WJAX 2012: Agile Teams im GleichgewichtWJAX 2012: Agile Teams im Gleichgewicht
WJAX 2012: Agile Teams im Gleichgewicht
Matthias Bohlen
 
Der entspannte Architekt
Der entspannte ArchitektDer entspannte Architekt
Der entspannte Architekt
Matthias Bohlen
 
Lean architecture
Lean architectureLean architecture
Lean architecture
Matthias Bohlen
 
Architektur vs Agilität
Architektur vs AgilitätArchitektur vs Agilität
Architektur vs Agilität
Matthias Bohlen
 
Risikomanagement mit Real Options
Risikomanagement mit Real OptionsRisikomanagement mit Real Options
Risikomanagement mit Real Options
Matthias Bohlen
 
STOP IT: Schätzen, verschätzen, nachverhandeln
STOP IT: Schätzen, verschätzen, nachverhandelnSTOP IT: Schätzen, verschätzen, nachverhandeln
STOP IT: Schätzen, verschätzen, nachverhandeln
Matthias Bohlen
 

Mehr von Matthias Bohlen (20)

"Einmal durch" in 90 Minuten
"Einmal durch" in 90 Minuten"Einmal durch" in 90 Minuten
"Einmal durch" in 90 Minuten
 
TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...
TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...
TAG2015: ArchiteKultur – wie bekommen wir Architekturarbeit in den Alltag rei...
 
Architektur = Kommunikation
Architektur = KommunikationArchitektur = Kommunikation
Architektur = Kommunikation
 
Softskills fördern den Projekterfolg
Softskills fördern den ProjekterfolgSoftskills fördern den Projekterfolg
Softskills fördern den Projekterfolg
 
Patterns effektiv einsetzen
Patterns effektiv einsetzenPatterns effektiv einsetzen
Patterns effektiv einsetzen
 
Warum Manager zu Designern werden müssen
Warum Manager zu Designern werden müssenWarum Manager zu Designern werden müssen
Warum Manager zu Designern werden müssen
 
Mehr Geld durch mehr Wert
Mehr Geld durch mehr WertMehr Geld durch mehr Wert
Mehr Geld durch mehr Wert
 
Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)
Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)
Anforderungen, Architektur, Projektvertrag – ein Trio von Freunden(?)
 
Not invented here – wie Teams besser zusammenarbeiten können
Not invented here – wie Teams besser zusammenarbeiten könnenNot invented here – wie Teams besser zusammenarbeiten können
Not invented here – wie Teams besser zusammenarbeiten können
 
Projekte richtig starten
Projekte richtig startenProjekte richtig starten
Projekte richtig starten
 
Medizin und Marketing – die Rolle des Softwarearchitekten heute
Medizin und Marketing – die Rolle des Softwarearchitekten heuteMedizin und Marketing – die Rolle des Softwarearchitekten heute
Medizin und Marketing – die Rolle des Softwarearchitekten heute
 
Gebrauchsanleitung für die Projektmatrix
Gebrauchsanleitung für die ProjektmatrixGebrauchsanleitung für die Projektmatrix
Gebrauchsanleitung für die Projektmatrix
 
WJAX 2014: Na klar muss alles "gestern" fertig sein
WJAX 2014: Na klar muss alles "gestern" fertig seinWJAX 2014: Na klar muss alles "gestern" fertig sein
WJAX 2014: Na klar muss alles "gestern" fertig sein
 
Softwarearchitektur entwerfen ohne dabei verrückt zu werden
Softwarearchitektur entwerfen ohne dabei verrückt zu werdenSoftwarearchitektur entwerfen ohne dabei verrückt zu werden
Softwarearchitektur entwerfen ohne dabei verrückt zu werden
 
WJAX 2012: Agile Teams im Gleichgewicht
WJAX 2012: Agile Teams im GleichgewichtWJAX 2012: Agile Teams im Gleichgewicht
WJAX 2012: Agile Teams im Gleichgewicht
 
Der entspannte Architekt
Der entspannte ArchitektDer entspannte Architekt
Der entspannte Architekt
 
Lean architecture
Lean architectureLean architecture
Lean architecture
 
Architektur vs Agilität
Architektur vs AgilitätArchitektur vs Agilität
Architektur vs Agilität
 
Risikomanagement mit Real Options
Risikomanagement mit Real OptionsRisikomanagement mit Real Options
Risikomanagement mit Real Options
 
STOP IT: Schätzen, verschätzen, nachverhandeln
STOP IT: Schätzen, verschätzen, nachverhandelnSTOP IT: Schätzen, verschätzen, nachverhandeln
STOP IT: Schätzen, verschätzen, nachverhandeln
 

WJAX 2014: Pah, ArchitekturDoku, darauf habe ich keine Lust!

  • 1. Pah, Architekturdokumentation ... darauf habe ich keine Lust! Matthias Bohlen http://mbohlen.de @mbohlende +49 170 772 8545 Asleep at the Wheel — Foto: Aaron Jacobs
  • 2. Die verwunderten Entwickler Eine Story aus dem wirklichen Leben Foto: GDC Europe
  • 3. Ausreden: Wir haben doch schon… Code Tests JavaDoc Das ist doch bereits unsere Doku – wozu noch mehr?
  • 4. Agilitäts-Missverständnis Wir schätzen "lauffähigen Code mehr als vollständige Dokumentation", deshalb machen wir keine !
  • 5. wenig Wir haben keine Lust uncool langweilig dringend Doku ist uncool Das liest ja eh keiner Anderes ist dringender Fotos: woods Jiang, Felix, Hartwig HKD
  • 6. Welcher Veraltet Nutzen? Zu viel Aufwand Echte Probleme Dokumente sind oft aufwändig, haben zu geringen Nutzen, oder sind veraltet. Fotos: José Carlos da Silva Encarnação, Matt Brown, Renee
  • 7. Doch Achtung! Dokumentation hat auch echte Vorteile! Foto: Martin Fisch
  • 8. Doku erleichtert die Einarbeitung neuer Teammitglieder Die Basics braucht man dann nur einmal zu erklären Foto: tapetenpics
  • 9. Doku beantwortet die Frage nach dem Warum Warum etwas so gemacht wurde, steht meist weder im Code noch in den Tests. Foto: Anna Vignet
  • 10. Doku macht Architektur nachvollziehbar Eine dokumentierte Architektur kann man gegen Qualitätsziele prüfen. Foto: Wm Jas
  • 11. Doku hilft, Fehler zu vermeiden Sie wollen, dass Ihr System rockt. ! Und, dass das auch so bleibt. Foto: Christian Kadluba
  • 12. Doku unterstützt beim Entwerfen und beim Entwickeln Wenn Sie etwas klar aufschreiben müssen, fokussiert das Ihre Gedanken. Foto: Jenn Kahalau
  • 13. Doku unterstützt Kommunikation im Projekt Am Whiteboard streiten und einigen, dann alles sauber aufschreiben. Foto: midnightcomm
  • 14. Angemessene Doku macht das Team schneller Doku-Investment Fokus auf die Arbeit M. Bohlens Erfahrung aus Projekten – Alle Zahlen in Prozent der Teamkapazität
  • 15. Die Lösung: Doku schrittweise angehen 7 Schritte zum Doku-Erfolg Foto: Shannon Kringen
  • 16. 1. Den Doku-Kümmerer finden Wie in der WG: ! Einer muss für Ordnung sorgen. Foto: Liza
  • 17. 2. Zielgruppe für Ihre Doku identifizieren Wer sind Ihre Stakeholder? ! Was sagt Ihr Vorgehensmodell? ! Welche Rollen? Welche Aufgaben? Welche Ergebnisse? Foto: Kevin Dooley
  • 18. 18 Stakeholder und deren Anliegen Rolle Anliegen Projektleiter Technische Risiken, Arbeitsaufteilung Entwickler Wie ist das Gesamtsystem aufgebaut? Tester Wodurch wurde Qualität bereitgestellt? Requirements Analyst Wodurch sind die Anforderungen abgedeckt? Betrieb Was bekommen wir zur Inbetriebnahme? Wo sind die Überwachungs-Schnittstellen? © ADOK Training Grundbegriffe
  • 19. 3. Inhalte pro Zielgruppe festlegen Wer hat welche Belange und braucht deshalb welche Sicht auf das System? ! Nicht jeder braucht alles zu lesen ! Foto: Internet Archive Book
  • 20. Dokumentationsmittel Virtueller Produktkarton Systemkontext Qualitätsziele Qualitätsszenario Persona Technische Risiken Glossar Architekturentscheidung Bausteinsicht Schnittstellenbeschreibung Laufzeitsicht Verteilungssicht Übergreifende Konzepte © ADOK Training Grundbegriffe 20
  • 21. Notationen UML-Diagramme ER-Diagramme Flussdiagramme Hierarchische Bäume Code-Beispiele Prosa-Texte Aufzählungen, Listen Tabellen ! ! Notation ist Form ! ! Dokumentationsmittel ist Aussage © ADOK Training Grundbegriffe 21
  • 22. 4. Medien zielgruppen-gerecht festlegen Sind die Mitglieder Ihrer Zielgruppe visuell oder auditiv veranlagt? ! Bieten Sie entspre-chende Medien an! Foto: Frédéric BISSON
  • 23. 5. Die Sache im Team machen, nicht einzeln Jeder soll das zur Doku beitragen, was er/sie hat und was einen Stakeholder interessiert ! Foto: 드림포유
  • 24. 6. Schreiben, ablegen, compilieren Der kreative Prozess ! Das sehen wir uns gleich noch etwas genauer an! Foto: Roger H. Goun
  • 25. 7. Verteilen und Feedback einholen War die Doku hilfreich für die Zielgruppe? ! Was fehlt? ! Was war zu viel? ! Welche Darstellung wäre noch hilfreicher? Foto: woodleywonderworks
  • 26. Der Erstellprozess für Dokumentation class Erstellprozess liest erzeugt Autor Leser schreibt in Build-Prozess liest Repository Dokument * Dokumentationsmittel extrahiert und aggregiert
  • 27. Beispiel-Toolkette für Erstellung und Ablage Klartext mit Markup für die Texte UML-Werkzeug für die oder Abbildungen Versionsmanagement- System als Ablage Typesetting Tool für die Ausgabe Konverter für eBooks
  • 28. Demo ! $ ./make.sh
  • 29. Ergebnis: PDF Kapitelnummern, Seitennummern, Inhaltsverzeichnis ! Sehr gut lesbar ! Souveräne Seitenaufteilung ! Navigierbar Chapter 6 Runtime View 6.1 Code generation These are the main steps (Figure 6.1) when AndroMDA generates code: Figure 6.1: Overview of the entire code generation process • The core is started by the build tool. • The core discovers the components on the classpath and configures itself from an-dromda. xml. • A repository loads a model. • A template engine loads a template. • A template parses itself and searches for placeholders. • When a placeholder is found, the template evaluates the expression that is contained in the placeholder. It invokes a metafacade to obtain a value that is needed inside the expression. • The metafacade gets the raw model information from the PIM and transforms it into a platform specific information. • After the template has evaluated the placeholder expression, it replaces the place-holder by the result of the evaluation. 14
  • 30. Ergebnis: HTML Keine Update- Problematik ! Für das Intranet immer aktuell ! Gut lesbar ! Navigierbar
  • 31. Ergebnis: eBook Blättern wie im Buch ! Gut lesbar ! Navigierbar ! Durchsuchbar ! Annotierbar
  • 32. Wenn Sie gute Doku auch für sich wollen… Dann sehen Sie sich mein kostenloses Video-Training an: ! ! ! ! ! Hier ist es: http://bit.ly/rockt2014
  • 33. Die Abkürzung zum Doku-Erfolg: Advanced Level Workshop mit Matthias Bohlen ! Software-architektur dokumentieren ! 24./25. November, Köln Mehr Infos über diesen Workshop: http://mbohlen.de/adok-de/
  • 34. Coaching nehmen Seminar besuchen Newsletter abonnieren Beginnen Sie jetzt! Newsletter, Blog, Artikel, Bücher, Podcast, Videos: http://mbohlen.de ! Anrufen: +49 170 772 8545 Fotos: Pascual López, Friends of Europe, iStockPhoto