some changes

Author: rdmueller

README.adoc

@@ -1,5 +1,7 @@
 :icons: font
 
+
+[role="demo"]
 == Doc-as-Code Workshop
 
 Dieses Readme führt durch eine Docs-as-Code Übung.

docToolchainConfig.groovy

@@ -26,6 +26,7 @@ inputFiles = [
         //[file: 'doctoolchain_demo.adoc',       formats: ['html','pdf']],
     //[file: 'arc42-template.adoc',    formats: ['html','pdf']],
 	[file: '01-arc42/arc42.adoc', formats: ['html','pdf']],
+	[file: '01-arc42/Fachlich.adoc', formats: ['html','pdf']],
 	/** inputFiles **/
 ]
 

src/docs/01-arc42/Fachlich.adoc

@@ -0,0 +1,66 @@
+:imagesdir: ../images
+:jbake-menu: -
+// header file for arc42-template,
+// including all help texts
+//
+// ====================================
+
+
+// configure DE settings for asciidoc
+include::chapters/config.adoc[]
+
+= image:arc42-logo.png[arc42] Template
+:revnumber: 8.2 DE
+:revdate: Januar 2023
+:revremark: (basiert auf AsciiDoc Version)
+// toc-title definition MUST follow document title without blank line!
+:toc-title: Inhaltsverzeichnis
+
+//additional style for arc42 help callouts
+ifdef::backend-html5[]
+++++
+<style>
+.arc42help {font-size:small; width: 14px; height: 16px; overflow: hidden; position: absolute; right: 0; padding: 2px 0 3px 2px;}
+.arc42help::before {content: "?";}
+.arc42help:hover {width:auto; height: auto; z-index: 100; padding: 10px;}
+.arc42help:hover::before {content: "";}
+@media print {
+	.arc42help {display:none;}
+}
+</style>
+++++
+endif::backend-html5[]
+
+
+include::chapters/about-arc42.adoc[]
+
+// horizontal line
+***
+
+ifdef::arc42help[]
+[role="arc42help"]
+****
+[NOTE]
+====
+Diese Version des Templates enthält Hilfen und Erläuterungen.
+Sie dient der Einarbeitung in arc42 sowie dem Verständnis der Konzepte.
+Für die Dokumentation eigener System verwenden Sie besser die _plain_ Version.
+====
+****
+endif::arc42help[]
+
+// numbering from here on
+:numbered:
+
+<<<<
+// 1. Anforderungen und Ziele
+include::chapters/01_introduction_and_goals.adoc[]
+
+<<<<
+// 2. Randbedingungen
+include::chapters/02_architecture_constraints.adoc[]
+
+<<<<
+// 3. Kontextabgrenzung
+include::chapters/03_context_and_scope.adoc[]
+

src/docs/01-arc42/chapters/08_concepts.adoc

@@ -13,53 +13,9 @@ ifndef::imagesdir[:imagesdir: ../../images]
 [[section-concepts]]
 == Querschnittliche Konzepte
 
-ifdef::arc42help[]
-[role="arc42help"]
-****
-.Inhalt
-Dieser Abschnitt beschreibt übergreifende, prinzipielle Regelungen und Lösungsansätze, die an mehreren Stellen (=_querschnittlich_) relevant sind.
-
-Solche Konzepte betreffen oft mehrere Bausteine.
-Dazu können vielerlei Themen gehören, beispielsweise:
-
-* Modelle, insbesondere fachliche Modelle
-* Architektur- oder Entwurfsmuster
-* Regeln für den konkreten Einsatz von Technologien
-* prinzipielle -- meist technische -- Festlegungen übergreifender Art
-* Implementierungsregeln
-
-.Motivation
-Konzepte bilden die Grundlage für _konzeptionelle Integrität_ (Konsistenz, Homogenität) der Architektur und damit eine wesentliche Grundlage für die innere Qualität Ihrer Systeme.
-
-Manche dieser Themen lassen sich nur schwer als Baustein in der Architektur unterbringen (z.B. das Thema „Sicherheit“).
-
-.Form
-Kann vielfältig sein:
-
-* Konzeptpapiere mit beliebiger Gliederung,
-* übergreifende Modelle/Szenarien mit Notationen, die Sie auch in den Architektursichten nutzen,
-* beispielhafte Implementierung speziell für technische Konzepte,
-* Verweise auf „übliche“ Nutzung von Standard-Frameworks (beispielsweise die Nutzung von Hibernate als Object/Relational Mapper).
-
-.Struktur
-Eine mögliche (nicht aber notwendige!) Untergliederung dieses Abschnittes könnte wie folgt aussehen (wobei die Zuordnung von Themen zu den Gruppen nicht immer eindeutig ist):
-
-* Fachliche Konzepte
-* User Experience (UX)
-* Sicherheitskonzepte (Safety und Security)
-* Architektur- und Entwurfsmuster
-* Unter-der-Haube
-* Entwicklungskonzepte
-* Betriebskonzepte
 
 image::08-concepts-DE.drawio.png["Possible topics for crosscutting concepts"]
 
-.Weiterführende Informationen
-
-Siehe https://docs.arc42.org/section-8/[Querschnittliche Konzepte] in der online-Dokumentation (auf Englisch).
-
-****
-endif::arc42help[]
 
 === _<Konzept 1>_
 

src/docs/01-arc42/chapters/09_architecture_decisions.adoc

@@ -8,36 +8,16 @@ ifndef::imagesdir[:imagesdir: ../../images]
 
 :toc:
 
+++++
+<style>
+.td-navbar { 
+    background-color: #e20074 ;
+    }
+</style>
+++++
 
 
 [[section-design-decisions]]
 == Architekturentscheidungen
 
-ifdef::arc42help[]
-[role="arc42help"]
-****
-.Inhalt
-Wichtige, teure, große oder riskante Architektur- oder Entwurfsentscheidungen inklusive der jeweiligen Begründungen.
-Mit "Entscheidungen" meinen wir hier die Auswahl einer von mehreren Alternativen unter vorgegebenen Kriterien.
-
-Wägen Sie ab, inwiefern Sie Entscheidungen hier zentral beschreiben, oder wo eine lokale Beschreibung (z.B. in der Whitebox-Sicht von Bausteinen) sinnvoller ist.
-Vermeiden Sie Redundanz.
-Verweisen Sie evtl. auf Abschnitt 4, wo schon grundlegende strategische Entscheidungen beschrieben wurden.
-
-.Motivation
-Stakeholder des Systems sollten wichtige Entscheidungen verstehen und nachvollziehen können.
-
-.Form
-Verschiedene Möglichkeiten:
-
-* ADR (https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions[Documenting Architecture Decisions]) für jede wichtige Entscheidung
-* Liste oder Tabelle, nach Wichtigkeit und Tragweite der Entscheidungen geordnet
-* ausführlicher in Form einzelner Unterkapitel je Entscheidung
-
-.Weiterführende Informationen
-
-Siehe https://docs.arc42.org/section-9/[Architekturentscheidungen] in der arc42 Dokumentation (auf Englisch!).
-Dort finden Sie Links und Beispiele zum Thema ADR.
-
-****
-endif::arc42help[]
+include::ADRs/ADR042-LLM-Chat.adoc[leveloffset=+1]

src/docs/01-arc42/chapters/ADRs/ADR042-LLM-Chat.adoc

@@ -0,0 +1,45 @@
+== ADR-042: Auswahl eines LLM-Chats für Architekturarbeit: OpenAI (ChatGPT)
+
+|===
+| Date:    h| 2025-05-22
+| Authors: h| Ralf D. Müller
+| Status:  h| Proposed
+|===
+
+=== Problem Description and Context
+
+Es soll ein LLM-Chat für Architekturarbeit eingesetzt werden. Es gibt keine spezifischen technischen oder organisatorischen Einschränkungen, und es gibt keine bestehenden Lösungen oder Systeme, die die Entscheidung beeinflussen.
+
+=== Alternative Evaluation (Pugh Matrix)
+
+|===
+| Kriterium | Baseline Solution (Mistral AI) | Alternative 1 (OpenAI) | Alternative 2 (Google) | Alternative 3 (Anthropic)
+| Kosten | 0 | -1 | -1 | -1
+| Performance | 0 | +1 | +1 | 0
+| Wartbarkeit | 0 | 0 | 0 | 0
+| Komplexität | 0 | 0 | 0 | 0
+| Human Eval Benchmark | 0 | +1 | +1 | +1
+| **Total Score** | 0 | +1 | +1 | 0
+|===
+
+=== Decision
+
+Basierend auf der Pugh-Matrix wird OpenAI (ChatGPT) gewählt, da es in den Kriterien Performance und Human Eval Benchmark besser abschneidet.
+
+=== Consequences
+
+==== Positive Effects
+
+- Verbesserte Performance und bessere Ergebnisse in Human Eval Benchmarks.
+
+==== Risks
+
+- Höhere Kosten im Vergleich zu Mistral AI.
+
+==== Technical Debt
+
+- Keine signifikanten technischen Schulden zu erwarten.
+
+=== Additional Information
+
+- Weitere Informationen zu den Alternativen können auf den jeweiligen Websites gefunden werden.