Markus Schlichting ist Senior Software Enginner bei Canoo Engineering in Basel und verfügt langjährige Erfahrung in der Softwareentwicklung.

Mit der Zeit hat er eine große Leidenschaft für Software Engineering, agile Methoden und Open Source entwickelt.

Er organisiert monatlich den Hackergarten in Basel und liebt es, beim Motorradfahren Frischluft zu tanken.

LOCATION: Basel
KEYWORDS: Networking, Concept, Meeting

SPEAKER: Markus Schlichting   COMPANY: Canoo Engineering AG

In täglichen Projekten ist jeder mit der Dokumentation konfrontiert und sich darüber bewusst, dass gute Dokumentation ebenso wertvoll ist wie Features, die unmittelbar sichtbaren 'Business Value' liefern.
Doch immer wieder erleben wir, das Dokumentation (zu) schnell veraltet, auf alten Code verweist oder überholte Code-Schnipsel beinhaltet.

Sowohl Wikis als auch Office Suiten haben sich schon zu häufig aus unterschiedlichen Gründen beim Vorhaben, Softwaresysteme zu dokumentieren, als unpraktisch erwiesen.

Das Duo aus AsciiDoctor und Gradle bietet einen Weg aus diesem Dilemma: Dokumentation, die nur durch Unittests validierte Code-Beispiele enthält Verknüpfung der Dokumentation im Build-Prozess und in der CI Umgebung um sie gebündelt mit einem Release auszuliefern - und so immer zu einem Softwarestand die richtige Dokumentation zur Hand zu haben.
Darüber hinaus kann dieses Setup die Grundlage dafür sein, Methodiken wie "Specification by Example" oder "Living Documentation" im Projekt umzusetzen und so mit geringerem Aufwand sicherzustellen, dass man nicht nur technisch korrekte, sondern auch die 'richtigen' Ergebnisse liefert.

Markus Schlichting ist Senior Software Enginner bei Canoo Engineering in Basel und verfügt langjährige Erfahrung in der Softwareentwicklung.

Mit der Zeit hat er eine große Leidenschaft für Software Engineering, agile Methoden und Open Source entwickelt.

Er organisiert monatlich den Hackergarten in Basel und liebt es, beim Motorradfahren Frischluft zu tanken.

---