Creative Commons Attribution-ShareAlike 4.0 International License. Under this license, you’re free to: • Share: copy and redistribute the material in any medium or format • Adapt: remix, transform, and build upon the material for any purpose, even commercially. unklar: Gilt das für Template, und/oder auch für Inhalte eigener Dokumentation?
itself is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. You are completely free to use or publish your own content, even if it is embedded in the arc42 template, according to your own rules. unklar: eigene Inhalte sind (natürlich) von der arc42 Lizenz NICHT betroffen!
Dokumentation arc42, die Achte Gernot Starke Für das ungeliebte Thema „Dokumentation" gibt es seit Jahren ein praktisches Helferlein aus der Open-Source-Ecke: arc42. An- fang 2022 erscheint die Version 8. Das nehme ich zum Anlass, Ihnen hier eine kurze Einführung in arc42 zu geben, einige Tipps zum praktischen Einsatz sowie einen Überblick über die Neue- rungen von V8. Das Vorbild war Volere [Vol], ein Template für Software-Requi- rements, das sich flexibel in beliebigen Entwicklungsprojekten zur Kommunikation und Dokumentation von Anforderungen (= dem Problemraum) einsetzen lässt. Peter und Gernot haben mit arc42 das Pendant für den Lösungsraum (== die Architektur) entwickelt. Von Beginn an stand das Vorhaben unter der Prämisse, arc42 kom- plett Open Source (siehe [GitHarc42]) zu entwickeln und frei ver- fügbar anzubieten. In zahlreichen Unternehmen gehört arc42 (siehe [arc42]) heute zu den etablierten Hilfsmitteln für die Entwicklung, Kommunikation und Dokumentation von Softwarearchitekturen. arc42 ist ein prag- matisches Template, gedacht für alle Beteiligten an Software- und Systementwicklung. Sie können arc42 komplett frei verwenden, da es unter einer liberalen Open-Source-Lizenz erstellt und publiziert wird. arc42 stammt aus der Praxis und basiert auf Erfahrungen in- ternationaler Architekturprojekte und Rückmeldungen vieler An- wenderinnen und Anwender. Ach ja, 42: Die etwas ältere Generation von Softwerkern mag den schrulligen britischen Science-Fiction-Autor Douglas Adams noch kennen, Douglas hat „Per Anhalter durch die Galaxis" [Wiki] geschrieben, in dem die Zahl 42 als die Antwort auf die „Ultima- tive Frage des Lebens, des Universums und dem ganzen Rest" er- scheint. arc42 soll für Ihre Systeme und Softwarearchitekturen die Antworten zumindest auf viele Fragen bezüglich Architektur- und Lösungsentscheidungen bereithalten. arc42 eignet sich für beliebige Technologien und Werkzeuge. Es passt großartig zu agilen und iterativen Entwicklungsvorgehen, aber auch andere Organisationsformen profitieren davon. Neben dem Template schlägt arcá2 einige Kernaufgaben zur Entwicklung Der Architektur-Schrank Vergleichen Sie arc42 mit einem Schubladenschrank: Die Schubla- und Konstruktion effektiver Softwarearchitekturen vor, auf die ich in diesem Artikel allerdings nicht weiter eingehe. den sind ordentlich beschriftet und enthalten zusammengehörige Informationen. arc42 enthält zwölf solche Fächer (s. Abb. 1). Die Bedeutung dieserarc42-Fächerist leicht verständlich. arc42 stammt von Dr. Gernot Starke und Dr. Peter Hruschka: Wir beide haben 2002 angefangen, unsere Erfahrungen vieler Ent- arc42 gibt Ihnen damit eine einfache, klare Struktur zur Be- wicklungs- und Architekturprojekte zusammenzutragen und eine flexibel wiederverwendbare Informationsstruktur (.Template") zu entwickeln. schreibung Ihrer (komplexen!) Systeme. Beginnend bei den Zielen und Anforderungen an Ihr System und die Einbettung in die fachli- che und technische Umgebung, können Sie nahezu alle Beteiligten 38 JavasPEKTRUM 1/2022 JavaSPEKTRUM 01/2022