arc42

arc42 ist ein Portal, das Softwarearchitekten das Leben erleichtert. Insbesondere stellt es ein Template zur Architekturdokumentation zur Verfügung und kürzt damit die leidige Diskussion in Projekten „Was sollen wir über unsere Architektur aufschreiben?“ und „Wie sollen wir dokumentieren?“ pragmatisch ab.

Das Template liegt in vielfältiger Form und in mehreren Sprachen vor: als Vorlage für Modeling-Tools, als Confluence-Wiki, aber auch als Word-Vorlage und als PDF; in Englisch, Deutsch und Spanisch. Nehmen Sie einfach eine davon und fangen Sie an, Ihre Architektur zu erklären.

Ändern Sie Ihre Grundeinstellung gegenüber Dokumentation. Das arc42-Template bietet Kreativitäts- und Arbeitshilfsmittel, Diskussionsgrundlage im Team, Einarbeitungsunterstützung für Projektneulinge und noch viel mehr. arc42 kostet keinen zusätzlichen Aufwand!

Architektur betreiben bedeutet, Entscheidungen zu treffen. Wir sehen es als Ihre Pflicht in der Architekturrolle an, Entwurfsentscheidungen in geeigneter Weise an alle Stakeholder zu kommunizieren. Dabei hilft Ihnen das strukturierte und pragmatische Festhalten der Entscheidungen im arc42-Template.

arc42 ist als Repository gedacht – als (elektronische) Sammlung aller architekturrelevanten Informationen. Deshalb bevorzugen wir die technische Umsetzung in Form eines Wikis oder mit einem Modellierungstool gegenüber Word-Dokumenten. Aus dem Repository heraus können Sie zielgruppengerechte Dokumente erzeugen – denn nicht jeder muss alles lesen ...

Dieser Pocket-Guide zeigt Ihnen arc42 anhand des Open-Source-Beispiels HtmlSanityCheck [hsc] – einem Tool zum Auffinden von Fehlern in HTML-Seiten. Sie finden jeweils auf der linken Buchseite die arc42-Dokumentation dieses Beispiels. Rechts daneben motivieren wir, warum das Kapitel geschrieben werden sollte, machen Vorschläge für den Inhalt und geben Tipps aus der Praxis.

Für mehr Informationen und noch mehr Beispiele finden Sie im Anhang weitere Bücher oder besuchen Sie die Websites www.arc42.de und www.aim42.org.