Wie Sie mit dem Docs-as-Code-Ansatz Ihre Dokumentation verbessern

Unser Kollege Ralf Müller war zu Gast bei der Java User Group Karlsruhe. In seinem Vortrag „Docs-as-Code - arc42, AsciiDoc, Gradle & Co. im Einsatz“ zeigt er, wie Sie die Qualität Ihrer Dokumentation erhöhen und gleichzeitig den Aufwand zur Pflege reduzieren, indem Sie Ihre Dokumentation genauso wie Ihren Code verwalten und in den Build integrieren. Anhand des Beispiels einer Architekturdokumentation, zeigt Ralf, wie Sie mit dem arc42-Template im AsciiDoc-Format und Gradle als Build-Tool einfach Diagramme in Ihre Dokumentation integrieren, Stakeholder-spezifische Dokumente erzeugen und verschiedene Ausgabeformate generieren. Reviewfähige PDF-Dokumente? Publishing nach Confluence? Integration einer Präsentation? Alles kein Problem! Einige Teile der 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. Erfahre mehr zum Thema: https://www.dbsystel.de/dbsystel/karr... Bleibe auf dem Laufenden: Abonnieren: http://bit.ly/2oQjKqI Facebook: http://bit.ly/2oQ25PM Twitter: http://bit.ly/2osURFf Die DB Systel GmbH mit Sitz in Frankfurt am Main ist hundertprozentige Tochter der DB AG und Digitalpartner für alle Konzern-Gesellschaften. Mit unserem ganzheitlichen, kundenspezifischen Angebot, das höchsten IT-Standards entspricht, treiben wir die Digitalisierung aller Gesellschaften der DB AG erfolgreich, integrativ und wertschaffend voran. Dafür entwickeln wir effektive und effiziente Kundenlösungen auf Basis innovativer Themen wie Cloud, Big Data, Internet of Things und künstliche Intelligenz. Als langfristiger Partner bringen wir fundierte Bahn- und IT-Kompetenz ein und agieren anbieterneutral für die gemeinsame Zielsetzung. Mehr dazu: https://www.dbsystel.de