Merge pull request #118 from LLM-Coding/copilot/improve-anchor-description-formatting

Convert anchor section labels to proper AsciiDoc section headers

Author: rdmueller

docs/anchors/_template.adoc

@@ -9,7 +9,7 @@
 ====
 Also known as:: Alternative Name, Other Name
 
-*Core Concepts*:
+== *Core Concepts*:
 
 Concept 1:: Brief description of concept 1
 
@@ -19,13 +19,13 @@ Concept 3:: Brief description of concept 3
 
 Key Proponents:: Author Name ("Book Title"), Another Author
 
-*When to Use*:
+== *When to Use*:
 
 * Use case 1
 * Use case 2
 * Use case 3
 
-*Related Anchors*:
+== *Related Anchors*:
 
 * <<related-anchor-1,Related Anchor Name>>
 * <<related-anchor-2,Another Related Anchor>>

docs/anchors/adr-according-to-nygard.adoc

@@ -6,7 +6,7 @@
 ====
 Full Name:: Architecture Decision Records according to Michael Nygard
 
-*Core Concepts*:
+== *Core Concepts*:
 
 Lightweight documentation:: Short, focused records
 
@@ -27,7 +27,7 @@ Evolutionary architecture:: Supporting architecture that changes over time
 
 Key Proponent:: Michael Nygard
 
-*When to Use*:
+== *When to Use*:
 
 * All software projects (low overhead, high value)
 * Distributed teams needing shared understanding

docs/anchors/adr-according-to-nygard.de.adoc

@@ -6,7 +6,7 @@
 ====
 Vollständiger Name:: Architecture Decision Records nach Michael Nygard
 
-*Kernkonzepte*:
+== *Kernkonzepte*:
 
 Leichtgewichtige Dokumentation:: Kurze, fokussierte Aufzeichnungen
 
@@ -28,7 +28,7 @@ Evolutionäre Architektur:: Unterstützung von Architektur, die sich im Laufe de
 
 Schlüsselvertreter:: Michael Nygard
 
-*Wann zu verwenden*:
+== *Wann zu verwenden*:
 
 * Alle Softwareprojekte (geringer Aufwand, hoher Wert)
 * Verteilte Teams, die gemeinsames Verständnis benötigen

docs/anchors/arc42.adoc

@@ -7,7 +7,7 @@
 ====
 Full Name:: arc42 Architecture Documentation Template
 
-*Core Concepts*:
+== *Core Concepts*:
 
 12 standardized sections:: From introduction to glossary
 
@@ -41,7 +41,7 @@ Multiple formats:: AsciiDoc, Markdown, Confluence, etc.
 
 Key Proponents:: Gernot Starke, Peter Hruschka
 
-*When to Use*:
+== *When to Use*:
 
 * Medium to large software projects
 * When stakeholder communication is critical

docs/anchors/arc42.de.adoc

@@ -7,7 +7,7 @@
 ====
 Vollständiger Name:: arc42 Architekturdokumentations-Template
 
-*Kernkonzepte*:
+== *Kernkonzepte*:
 
 12 standardisierte Abschnitte:: Von Einführung bis Glossar
 
@@ -42,7 +42,7 @@ Mehrere Formate:: AsciiDoc, Markdown, Confluence, etc.
 
 Schlüsselvertreter:: Gernot Starke, Peter Hruschka
 
-*Wann zu verwenden*:
+== *Wann zu verwenden*:
 
 * Mittlere bis große Softwareprojekte
 * Wenn Stakeholder-Kommunikation kritisch ist

docs/anchors/bem-methodology.adoc

@@ -7,7 +7,7 @@
 ====
 Full Name:: Block Element Modifier (BEM) (S)CSS Methodology
 
-*Core Concepts*:
+== *Core Concepts*:
 
 Motivation:: Solve CSS specificity wars, naming conflicts, and stylesheet maintainability issues in large codebases
 
@@ -32,15 +32,15 @@ Mix:: Combining multiple BEM entities on a single DOM node
 File structure:: Often paired with component-based file organization
 
 
-*Naming Examples*:
+== *Naming Examples*:
 
 * Block: `.search-form`
 * Element: `.search-form__input`, `.search-form__button`
 * Modifier: `.search-form--compact`, `.search-form__button--disabled`
 
 Key Proponents:: Yandex development team
 
-*When to Use*:
+== *When to Use*:
 
 * Large-scale web applications with many components
 * Team projects requiring consistent (S)CSS naming conventions

docs/anchors/bem-methodology.de.adoc

@@ -7,7 +7,7 @@
 ====
 Vollständiger Name:: Block Element Modifier (BEM) (S)CSS-Methodologie
 
-*Kernkonzepte*:
+== *Kernkonzepte*:
 
 Motivation:: CSS-Spezifitätskriege, Namenskonflikte und Stylesheet-Wartbarkeitsprobleme in großen Codebasen lösen
 
@@ -32,15 +32,15 @@ Mix:: Kombination mehrerer BEM-Entitäten auf einem einzigen DOM-Knoten
 Dateistruktur:: Oft gepaart mit komponentenbasierter Dateiorganisation
 
 
-*Benennungsbeispiele*:
+== *Benennungsbeispiele*:
 
 * Block: `.search-form`
 * Element: `.search-form__input`, `.search-form__button`
 * Modifier: `.search-form--compact`, `.search-form__button--disabled`
 
 Schlüsselvertreter:: Yandex Entwicklungsteam
 
-*Wann zu verwenden*:
+== *Wann zu verwenden*:
 
 * Großangelegte Webanwendungen mit vielen Komponenten
 * Teamprojekte, die konsistente (S)CSS-Namenskonventionen erfordern

docs/anchors/bluf.adoc

@@ -9,7 +9,7 @@ Full Name:: BLUF (Bottom Line Up Front)
 
 Also known as:: Direct Answer Format, Conclusion-First Communication
 
-*Core Concepts*:
+== *Core Concepts*:
 
 Conclusion First:: State the main point, decision, or recommendation immediately
 
@@ -32,7 +32,7 @@ Key Proponents:: US Military (Army writing standards), adopted broadly in busine
 
 Historical Context:: Standardized in military communication where rapid decision-making is critical; now standard in business writing (McKinsey, consulting, executive communication)
 
-*When to Use*:
+== *When to Use*:
 
 * Executive summaries and briefings
 * Status reports to leadership
@@ -41,7 +41,7 @@ Historical Context:: Standardized in military communication where rapid decision
 * Any high-stakes communication where the reader needs the conclusion first
 * Technical documentation for time-constrained readers
 
-*Relationship to Other Anchors*:
+== *Relationship to Other Anchors*:
 
 * Related to <<pyramid-principle,Pyramid Principle>> but more narrowly focused on conclusion-first structure
 * Complements MECE by providing the organizational principle for grouped information

docs/anchors/bluf.de.adoc

@@ -9,7 +9,7 @@ Vollständiger Name:: BLUF (Bottom Line Up Front - Das Wichtigste zuerst)
 
 Auch bekannt als:: Direkte Antwortformat, Schlussfolgerung-zuerst-Kommunikation
 
-*Kernkonzepte*:
+== *Kernkonzepte*:
 
 Schlussfolgerung zuerst:: Nennen Sie den Hauptpunkt, die Entscheidung oder Empfehlung sofort
 
@@ -32,7 +32,7 @@ Schlüsselvertreter:: US-Militär (Army writing standards), weithin in Wirtschaf
 
 Historischer Kontext:: Standardisiert in militärischer Kommunikation, wo schnelle Entscheidungsfindung kritisch ist; jetzt Standard im Business Writing (McKinsey, Consulting, Führungskommunikation)
 
-*Wann zu verwenden*:
+== *Wann zu verwenden*:
 
 * Executive Summaries und Briefings
 * Statusberichte an Führungskräfte
@@ -41,7 +41,7 @@ Historischer Kontext:: Standardisiert in militärischer Kommunikation, wo schnel
 * Jede hochkritische Kommunikation, bei der der Leser die Schlussfolgerung zuerst benötigt
 * Technische Dokumentation für zeitbeschränkte Leser
 
-*Beziehung zu anderen Ankern*:
+== *Beziehung zu anderen Ankern*:
 
 * Verwandt mit dem <<pyramid-principle,Pyramid Principle>>, aber enger auf die Schlussfolgerung-zuerst-Struktur fokussiert
 * Ergänzt MECE durch Bereitstellung des Organisationsprinzips für gruppierte Informationen

docs/anchors/c4-diagrams.adoc

@@ -6,7 +6,7 @@
 ====
 Full Name:: C4 Model for Software Architecture Diagrams
 
-*Core Concepts*:
+== *Core Concepts*:
 
 Four levels of abstraction::
 +
@@ -26,7 +26,7 @@ Supplementary diagrams:: Deployment, dynamic views, etc.
 
 Key Proponent:: Simon Brown
 
-*When to Use*:
+== *When to Use*:
 
 * Communicating architecture to diverse stakeholders
 * Onboarding new team members