Vergangen

  • Spock und Geb: Übersichtlich und nachvollziehbar Testen für alle!
    Entwicklertag Karlsruhe 2015, Karlsruhe, 2015-05-23, [ralfdmueller]

  • Spock und Geb: Übersichtlich und nachvollziehbar Testen für alle!
    Javaland, Brühl, 2016-03-08, [ralfdmueller]

  • Spock und Geb: Übersichtlich und nachvollzierbar Testen für alle!
    DevOps Würzburg Mainfranken, Würzburg, 2016-10-10, [ralfdmueller, tokraft]

  • Dokumentation am (Riesen-)Beispiel – arc42, AsciiDoc und Co. in Aktion
    JAX 2017, Mainz, 2017-05-10, [ralfdmueller, gernotstarke]

  • The Hitchhikers Guide to painless Documentation
    DB, Frankfurt, 2017-06-27, [ralfdmueller]

  • Spock & Geb: Clear and comprehensible tests!
    DB, Frankfurt, 2017-06-27, [ralfdmueller]

  • Hitchhikers Guide to Architecture Documentation
    Software Architecture Summit 2017, Berlin, 2017-09-18, [ralfdmueller, gernotstarke]

  • Docs-as-Code
    JUG Darmstadt, Darmstadt, 2017-12-07, [ralfdmueller, sippsack]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    Entwicklertag Frankfurt, Frankfurt, 2018-02-21, [ralfdmueller]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    Entwicklertag Frankfurt, Frankfurt, 2018-02-21, [ralfdmueller]

  • Docs-as code: arc42, AsciiDoc, Gradle & Co. combined
    Gr8conf-Conf, Copenhagen/Denmark, 2018-03-31, [ralfdmueller]

  • Docs-as-Code - Architekturdokumentation leicht gemacht
    JAX 2018, Mainz, 2018-04-26, [ralfdmueller, sippsack]

  • Docs-as code: arc42, AsciiDoc, Gradle & Co. combined
    Greach-Conf, Madrid/Spain, 2018-05-17, [ralfdmueller]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    Java User Group Frankfurt, Deutsche Nationalbibliothek Frankfurt, 2018-08-28, [ralfdmueller]

  • Docs-as-Code: Anatomie einer realen Systemdokumentation
    W-Jax 2018, München, 2018-11-06, [ralfdmueller, gernotstarke]

  • Docs-as-Code: Anatomie einer smarten Systemdokumentation
    OOP 2019, München, 2019-01-22, [ralfdmueller, gernotstarke]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    JavaLand 2019, Brühl, 2019-03-19, [ralfdmueller]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    JUG Dortmund, Dortmund, 2019-04-08, [ralfdmueller]

  • Docs as Code, arc42, AsciiDoc, Gradle und Antora im Einsatz
    JAX 2019, Mainz, 2019-05-08, [ralfdmueller]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    Java User Group Karlsruhe, Karlsruhe, 2019-06-05, [ralfdmueller]

  • BDD mit Spock und Geb
    German Testing Day, Frankfurt, 2019-06-07, [ralfdmueller]

  • Spock and AsciiDoc - a perfect match
    Write the Docs, Karlsruhe, 2019-06-19, [ralfdmueller]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    JUG Saxony Day, Radebeul, 2019-09-13, [ralfdmueller]

  • Spock and AsciiDoc - ein perfektes Paar
    JUG Saxony Day, Radebeul, 2019-09-13, [ralfdmueller]

  • Docs-as-Code: Anatomie einer smarten Systemdokumentation
    IT-Tage, Frankfurt, 2019-12-10, [ralfdmueller, gernotstarke]

  • Spock vs Supermutanten: Spezifikationstesten trifft Mutationstesten
    OOP / Code Days, München, 2020-02-04, [ralfdmueller, johannesdienst]

  • Docs-as-Code, arc42, AsciiDoc, Gradle & Co. im Einsatz
    Java User Group Erfurt, Erfurt, 2020-02-18, [ralfdmueller]

  • Spock und AsciiDoc – Vom Test zur Spezifikation und zurück
    Frankfurter Entwicklertag 2020, Frankfurt, 2020-02-20, [ralfdmueller]

  • Spock vs Supermutanten: Spezifikationstesten trifft Mutationstesten
    CyberLand 2020, online, 2020-03-17, [ralfdmueller]

  • Spock vs Supermutanten: Spezifikationstesten trifft Mutationstesten
    SAEC Days 2020, online, 2020-07-23, [ralfdmueller, johannesdienst]

  • Spock und AsciiDoc - vom Test zur Spezifikation und zurück
    German Testing Day 2020, Online, 2020-09-02, [ralfdmueller]

  • Spock vs Supermutanten: Spezifikationstesten trifft Mutationstesten
    JCON 2020, Online, 2020-10-27, [ralfdmueller, johannesdienst]

Details

Spock und Geb: Übersichtlich und nachvollziehbar Testen für alle!

Bei automatisierten Tests ist es oftmals nicht einfach nachzuvollziehen was getestet wurde. Des Weiteren laufen Tests meist durch und geben nur im Fehlerfall etwas aus. Wie soll man mit dem Fachbereich kommunizieren, was getestet wurde?

Die beiden auf Groovy basierenden Frameworks Spock und Geb sorgen seit einiger Zeit für Aufsehen in der Java-Welt. Über Spock werden die Tests schon um einiges lesbarer. Durch die zusätzliche Nutzung von Geb lassen sich funktionale Tests aus der Sicht des Nutzers erstellen - so zu sagen die automatisierte Testfahrt der Applikation. Was noch fehlt sind gute Reports, die das Testvorgehen für alle Beteiligten nachvollziehbar machen.

Spock & Geb: Clear and comprehensible tests!

Dokumentation am (Riesen-)Beispiel – arc42, AsciiDoc und Co. in Aktion

Anhand eines großen Systems zeigen Gernot und Ralf, wie Sie mit ziemlich wenig Aufwand angemessene und vernünftige Dokumentation für unterschiedliche Stakeholder produzieren – sodass Entwicklungsteams dabei auch noch Spaß haben.

Unser Rezept: AsciiDoc mit arc42 mischen, Automatisierung mit Gradle und Maven hinzufügen und mit Diagramm- oder Modellierungstools Ihrer Wahl kombinieren. Schon sind schicke HTML- und reviewfähige PDF-Dokumente fertig. Auf Wunsch gibts DOCX und Confluence als Zugabe.

Wir zeigen, wie Sie Doku genau wie Quellcode verwalten können, stakeholderspezifische Dokumente erzeugen und Diagramme automatisiert integrieren können. Einige Teile dieser Doku können Sie sogar automatisiert testen.

Zwischendurch bekommen Sie zahlreiche Tipps, wie und wo Sie systematisch den Aufwand für Dokumentation reduzieren können und trotzdem lesbare, verständliche und praxistaugliche Ergebnisse produzieren.

g

Ideen

Dieser Abschnitt enthält Ideen für Talks, die noch ausgearbeitet werden müssen.

Doku-Microsites mit jBake

Dokumentation in Markdown oder AsciiDoc zu erstellen ist einfach. GitHub, GitLab und Bitbucket zeigen die Dokumente schon gleich im Repository als HTML-Seite an.

Doch wie bekomme ich aus diesen Dokumenten jetzt eine schicke Website hin, die nicht nur das Projekt dokumentiert, sondern auch das Projekt über eine nette Landingpage vorstellt, die Architektur bereitstellt und einen Newsfeed anbietet?

In diesem Vortrag zeige ich, warum sich jBake gerade für Java-Projekte ausgezeichnet eignet, um für jedes Projekt mit wenig Aufwand eine schicke Microsite zu erstellen. Vom Plain-Text-Dokument bis zur veröffentlichten Website mit TLS.

Dabei werde ich viele Tricks und Kniffe aus dem Projektalltag einfließen lassen. Landingpage, Architekturdokumentation mit arc42, Anwender-Doku mit AsciiDoc, Blog mit RSS-Feed und eine Suche werden kombiniert und einfach in das bestehende Projekt-Repository entsprechend dem Docs-as-Code-Ansatz integriert. Über ein Open Source Template wird er Einstieg in die Erstellung einer eigenen Microsite nach dem Vortrag erleichtert.

Documentation Driven Development

Was passiert, wenn ein Entwickler sich intensiv mit dem Docs-as-Code Ansatz beschäftigt und ihn auf die Spitze treibt? Richtig - Dokumentation etnwickelt sich von der Nebensache, die man erledigt, wenn das Projekt läuft (also nie) zur zentralen Komponente, die zuerst erstellt wird und nach der das Projekt umsetzt wird.

Durch Docs-as-Code besteht die Dokumentation nicht mehr aus verschiedensten Fragmenten wie Anforderungen, Stories und Architektur, die alle in unterschiedlichen Systemen verwaltet werden und somit Medienbrüche unumgängig machen.

Die Anforderungen können nun in einem System mit Stories angereichert und diese durch Akzeptanzkriterien untermauert werden. Durch Transformationen wird aus den Akzeptanzkriterien ein Test-Gerüst, welches vom Entwickler durch Testimplementierungen belebt wird. An dieser Stelle geht der Ansatz dann von Documentation-Driven auf Test-Driven über.

Die Ergebnisse ausführbaren Akzeptanztests werden möglichst anscheilich wieder in die Stories und somit Anforderungen zurückgespielt und das Projekt erhält somit eine ausführbare Spezifikation.

5 Jahre Docs-as-Code mit docToolchain

In dieser Session nehme ich alle Teilnehmer mit auf einen kurzen Ausflug durch 5 Jahre docToolchain. Auf dieser Reise werden wir zwei Zeitstränge betrachten.

Zum Einen die Entwicklung des Docs-as-Code Ansatzes vom einfachen "Markdown im Repository" bis zu neueren Entwicklungen wie z.B. komfortablen Text-Editor-Plugins in der IDE oder Documentation-Driven-Development.

Zum Anderen werde ich über meine Reise mit dem Open-Source-Projekt docToolchain, vom Script zum Tool berichten. Erfahrungsbericht pur :-)