Skip to content

Commit fcda3e8

Browse files
authored
Merge branch 'LLM-Coding:main' into main
2 parents f96ef8f + 7ff651d commit fcda3e8

39 files changed

+5034
-603
lines changed

docs/all-anchors.adoc

Lines changed: 99 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,25 +11,83 @@ include::about.adoc[leveloffset=+1]
1111

1212
include::anchors/bluf.adoc[leveloffset=+2]
1313

14-
include::anchors/chatham-house-rule.adoc[leveloffset=+2]
14+
include::anchors/gutes-deutsch-wolf-schneider.adoc[leveloffset=+2]
1515

1616
include::anchors/mece.adoc[leveloffset=+2]
1717

18+
include::anchors/myers-briggs-type-indicator.adoc[leveloffset=+2]
19+
20+
include::anchors/plain-english-strunk-white.adoc[leveloffset=+2]
21+
22+
include::anchors/problem-space-nvc.adoc[leveloffset=+2]
23+
1824
include::anchors/pyramid-principle.adoc[leveloffset=+2]
1925

2026
<<<
2127

2228
== Design Principles & Patterns
2329

24-
include::anchors/dry-principle.adoc[leveloffset=+2]
25-
2630
include::anchors/fowler-patterns.adoc[leveloffset=+2]
2731

32+
include::anchors/gof-abstract-factory-pattern.adoc[leveloffset=+2]
33+
34+
include::anchors/gof-adapter-pattern.adoc[leveloffset=+2]
35+
36+
include::anchors/gof-bridge-pattern.adoc[leveloffset=+2]
37+
38+
include::anchors/gof-builder-pattern.adoc[leveloffset=+2]
39+
40+
include::anchors/gof-chain-of-responsibility-pattern.adoc[leveloffset=+2]
41+
42+
include::anchors/gof-command-pattern.adoc[leveloffset=+2]
43+
44+
include::anchors/gof-composite-pattern.adoc[leveloffset=+2]
45+
46+
include::anchors/gof-decorator-pattern.adoc[leveloffset=+2]
47+
2848
include::anchors/gof-design-patterns.adoc[leveloffset=+2]
2949

50+
include::anchors/gof-facade-pattern.adoc[leveloffset=+2]
51+
52+
include::anchors/gof-factory-method-pattern.adoc[leveloffset=+2]
53+
54+
include::anchors/gof-flyweight-pattern.adoc[leveloffset=+2]
55+
56+
include::anchors/gof-interpreter-pattern.adoc[leveloffset=+2]
57+
58+
include::anchors/gof-iterator-pattern.adoc[leveloffset=+2]
59+
60+
include::anchors/gof-mediator-pattern.adoc[leveloffset=+2]
61+
62+
include::anchors/gof-memento-pattern.adoc[leveloffset=+2]
63+
64+
include::anchors/gof-observer-pattern.adoc[leveloffset=+2]
65+
66+
include::anchors/gof-prototype-pattern.adoc[leveloffset=+2]
67+
68+
include::anchors/gof-proxy-pattern.adoc[leveloffset=+2]
69+
70+
include::anchors/gof-singleton-pattern.adoc[leveloffset=+2]
71+
72+
include::anchors/gof-state-pattern.adoc[leveloffset=+2]
73+
74+
include::anchors/gof-strategy-pattern.adoc[leveloffset=+2]
75+
76+
include::anchors/gof-template-method-pattern.adoc[leveloffset=+2]
77+
78+
include::anchors/gof-visitor-pattern.adoc[leveloffset=+2]
79+
80+
include::anchors/solid-dip.adoc[leveloffset=+2]
81+
82+
include::anchors/solid-isp.adoc[leveloffset=+2]
83+
84+
include::anchors/solid-lsp.adoc[leveloffset=+2]
85+
86+
include::anchors/solid-ocp.adoc[leveloffset=+2]
87+
3088
include::anchors/solid-principles.adoc[leveloffset=+2]
3189

32-
include::anchors/spot-principle.adoc[leveloffset=+2]
90+
include::anchors/solid-srp.adoc[leveloffset=+2]
3391

3492
include::anchors/ssot-principle.adoc[leveloffset=+2]
3593

@@ -43,8 +101,16 @@ include::anchors/bem-methodology.adoc[leveloffset=+2]
43101

44102
include::anchors/conventional-commits.adoc[leveloffset=+2]
45103

104+
include::anchors/definition-of-done.adoc[leveloffset=+2]
105+
106+
include::anchors/github-flow.adoc[leveloffset=+2]
107+
46108
include::anchors/mental-model-according-to-naur.adoc[leveloffset=+2]
47109

110+
include::anchors/mikado-method.adoc[leveloffset=+2]
111+
112+
include::anchors/regulated-environment.adoc[leveloffset=+2]
113+
48114
include::anchors/semantic-versioning.adoc[leveloffset=+2]
49115

50116
include::anchors/sota.adoc[leveloffset=+2]
@@ -87,16 +153,18 @@ include::anchors/five-whys.adoc[leveloffset=+2]
87153

88154
include::anchors/morphological-box.adoc[leveloffset=+2]
89155

90-
include::anchors/rubber-duck-debugging.adoc[leveloffset=+2]
91-
92156
<<<
93157

94158
== Requirements Engineering
95159

96160
include::anchors/ears-requirements.adoc[leveloffset=+2]
97161

162+
include::anchors/invest.adoc[leveloffset=+2]
163+
98164
include::anchors/moscow.adoc[leveloffset=+2]
99165

166+
include::anchors/prd.adoc[leveloffset=+2]
167+
100168
include::anchors/problem-space-nvc.adoc[leveloffset=+2]
101169

102170
include::anchors/user-story-mapping.adoc[leveloffset=+2]
@@ -107,8 +175,6 @@ include::anchors/user-story-mapping.adoc[leveloffset=+2]
107175

108176
include::anchors/adr-according-to-nygard.adoc[leveloffset=+2]
109177

110-
include::anchors/cqrs.adoc[leveloffset=+2]
111-
112178
include::anchors/arc42.adoc[leveloffset=+2]
113179

114180
include::anchors/atam.adoc[leveloffset=+2]
@@ -117,6 +183,8 @@ include::anchors/c4-diagrams.adoc[leveloffset=+2]
117183

118184
include::anchors/clean-architecture.adoc[leveloffset=+2]
119185

186+
include::anchors/cqrs.adoc[leveloffset=+2]
187+
120188
include::anchors/domain-driven-design.adoc[leveloffset=+2]
121189

122190
include::anchors/event-driven-architecture.adoc[leveloffset=+2]
@@ -151,6 +219,8 @@ include::anchors/jobs-to-be-done.adoc[leveloffset=+2]
151219

152220
include::anchors/pugh-matrix.adoc[leveloffset=+2]
153221

222+
include::anchors/swot.adoc[leveloffset=+2]
223+
154224
include::anchors/wardley-mapping.adoc[leveloffset=+2]
155225

156226
<<<
@@ -159,17 +229,37 @@ include::anchors/wardley-mapping.adoc[leveloffset=+2]
159229

160230
include::anchors/bdd-given-when-then.adoc[leveloffset=+2]
161231

232+
include::anchors/fagan-inspection.adoc[leveloffset=+2]
233+
234+
include::anchors/gherkin.adoc[leveloffset=+2]
235+
162236
include::anchors/iec-61508-sil-levels.adoc[leveloffset=+2]
163237

238+
include::anchors/linddun.adoc[leveloffset=+2]
239+
164240
include::anchors/mutation-testing.adoc[leveloffset=+2]
165241

242+
include::anchors/owasp-top-10.adoc[leveloffset=+2]
243+
166244
include::anchors/property-based-testing.adoc[leveloffset=+2]
167245

246+
include::anchors/stride.adoc[leveloffset=+2]
247+
168248
include::anchors/tdd-chicago-school.adoc[leveloffset=+2]
169249

250+
include::anchors/tdd-london-school.adoc[leveloffset=+2]
251+
252+
include::anchors/test-double-dummy.adoc[leveloffset=+2]
253+
254+
include::anchors/test-double-fake.adoc[leveloffset=+2]
255+
170256
include::anchors/test-double-meszaros.adoc[leveloffset=+2]
171257

172-
include::anchors/tdd-london-school.adoc[leveloffset=+2]
258+
include::anchors/test-double-mock.adoc[leveloffset=+2]
259+
260+
include::anchors/test-double-spy.adoc[leveloffset=+2]
261+
262+
include::anchors/test-double-stub.adoc[leveloffset=+2]
173263

174264
include::anchors/testing-pyramid.adoc[leveloffset=+2]
175265

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
= Definition of Done
2+
:categories: development-workflow
3+
:roles: software-developer, qa-engineer, product-owner, team-lead
4+
:related: bdd-given-when-then, user-story-mapping, moscow
5+
:proponents: Ken Schwaber, Jeff Sutherland
6+
:tags: dod, acceptance criteria, scrum, agile, quality gates, done, sprint, increment
7+
:tier: 3
8+
9+
[%collapsible]
10+
====
11+
Also known as:: DoD, Done Criteria, Acceptance Criteria (team-level)
12+
13+
[discrete]
14+
== *Core Concepts*:
15+
16+
Shared agreement:: A formal, team-wide checklist of quality criteria that every increment must satisfy before it is declared "done"
17+
18+
Increment quality gates:: Concrete, verifiable conditions — e.g., code reviewed, tests passing, documentation updated, no known defects
19+
20+
Transparency:: Makes the meaning of "done" visible and unambiguous to all stakeholders, preventing hidden technical debt
21+
22+
Sprint-level vs. product-level DoD:: Teams may maintain separate DoD lists for Sprint increments and for releasable product increments
23+
24+
Continuous refinement:: The DoD evolves as the team matures; stricter gates are added over time
25+
26+
Undone work:: Work that does not meet the DoD is not counted as complete; it returns to the Product Backlog
27+
28+
Shared responsibility:: The entire Scrum team (Developers, Product Owner, Scrum Master) owns and respects the DoD
29+
30+
31+
Key Proponents:: Ken Schwaber & Jeff Sutherland ("The Scrum Guide", 2020); Mike Cohn ("Succeeding with Agile", 2009)
32+
33+
[discrete]
34+
== *When to Use*:
35+
36+
* Establishing a consistent quality standard across a Scrum or agile team
37+
* Onboarding new team members so they understand what "finished" means
38+
* Reducing rework and late-cycle defects by agreeing on criteria upfront
39+
* Aligning developers, QA, and product owners on release readiness
40+
41+
[discrete]
42+
== *Related Anchors*:
43+
44+
* <<bdd-given-when-then,BDD (Behavior-Driven Development)>> - Given-When-Then scenarios that operationalize acceptance criteria
45+
* <<user-story-mapping,User Story Mapping>> - Planning technique that identifies the scope Definition of Done must cover
46+
* <<moscow,MoSCoW>> - Prioritization method used to decide which DoD items are must-haves
47+
====
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
= Definition of Done
2+
:categories: development-workflow
3+
:roles: software-developer, qa-engineer, product-owner, team-lead
4+
:related: bdd-given-when-then, user-story-mapping, moscow
5+
:proponents: Ken Schwaber, Jeff Sutherland
6+
:tags: dod, acceptance criteria, scrum, agile, quality gates, done, sprint, increment
7+
:tier: 3
8+
9+
[%collapsible]
10+
====
11+
Auch bekannt als:: DoD, Done-Kriterien, Akzeptanzkriterien (Teamebene)
12+
13+
[discrete]
14+
== *Kernkonzepte*:
15+
16+
Gemeinsame Vereinbarung:: Eine formelle, teamweite Checkliste von Qualitätskriterien, die jedes Inkrement erfüllen muss, bevor es als „fertig" gilt
17+
18+
Inkrementelle Qualitätsgates:: Konkrete, überprüfbare Bedingungen — z. B. Code reviewed, Tests bestanden, Dokumentation aktualisiert, keine bekannten Defekte
19+
20+
Transparenz:: Macht die Bedeutung von „fertig" für alle Stakeholder sichtbar und eindeutig und verhindert versteckte technische Schulden
21+
22+
Sprint-DoD vs. Produkt-DoD:: Teams können separate DoD-Listen für Sprint-Inkremente und für auslieferbare Produktinkremente pflegen
23+
24+
Kontinuierliche Verfeinerung:: Die DoD entwickelt sich mit der Teamreife weiter; im Laufe der Zeit werden strengere Gates hinzugefügt
25+
26+
Nicht erledigte Arbeit:: Arbeit, die die DoD nicht erfüllt, gilt nicht als abgeschlossen und kehrt in den Product Backlog zurück
27+
28+
Gemeinsame Verantwortung:: Das gesamte Scrum-Team (Entwickler, Product Owner, Scrum Master) besitzt und respektiert die DoD
29+
30+
31+
Schlüsselvertreter:: Ken Schwaber & Jeff Sutherland ("The Scrum Guide", 2020); Mike Cohn ("Succeeding with Agile", 2009)
32+
33+
[discrete]
34+
== *Wann zu verwenden*:
35+
36+
* Einrichtung eines konsistenten Qualitätsstandards in einem Scrum- oder agilen Team
37+
* Onboarding neuer Teammitglieder, damit sie verstehen, was „fertig" bedeutet
38+
* Reduzierung von Nacharbeit und späten Defekten durch vorherige Einigung auf Kriterien
39+
* Abstimmung von Entwicklern, QA und Product Ownern auf die Release-Bereitschaft
40+
41+
[discrete]
42+
== *Verwandte Anker*:
43+
44+
* <<bdd-given-when-then,BDD (Behavior-Driven Development)>> - Given-When-Then-Szenarien, die Akzeptanzkriterien operationalisieren
45+
* <<user-story-mapping,User Story Mapping>> - Planungstechnik, die den Umfang identifiziert, den die DoD abdecken muss
46+
* <<moscow,MoSCoW>> - Priorisierungsmethode, um zu entscheiden, welche DoD-Punkte Must-haves sind
47+
====

docs/anchors/fagan-inspection.adoc

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
= Fagan Inspection
2+
:categories: testing-quality
3+
:roles: software-developer, qa-engineer, software-architect, team-lead
4+
:related: mutation-testing, testing-pyramid
5+
:proponents: Michael Fagan
6+
:tags: code-review, inspection, defect-detection, formal-review, static-analysis
7+
:tier: 3
8+
9+
[%collapsible]
10+
====
11+
Also known as:: Formal Code Inspection, Software Inspection, Fagan's Inspection Method
12+
13+
[discrete]
14+
== Core Concepts:
15+
16+
Formal inspection process:: A structured, multi-phase review process for software artifacts (requirements, design, code) with defined roles and entry/exit criteria
17+
18+
Roles:: Moderator (facilitates and logs), Author (created the artifact), Inspectors (reviewers), Recorder (documents defects)
19+
20+
Six phases:: Planning → Overview → Preparation → Inspection Meeting → Rework → Follow-up
21+
22+
Entry and exit criteria:: Explicit conditions that must be met before entering and leaving each phase, preventing premature progression
23+
24+
Defect classification:: Defects are categorized by type (missing, wrong, extra) and severity, enabling process improvement through causal analysis
25+
26+
Metrics-driven:: Inspection data (defect rate, inspection rate) are collected and used to improve both the product and the inspection process itself
27+
28+
Key Proponents:: Michael Fagan ("Design and Code Inspections to Reduce Errors in Program Development", IBM Systems Journal, 1976)
29+
30+
[discrete]
31+
== When to Use:
32+
33+
* Safety-critical or high-assurance software where defect escape is costly
34+
* Reviewing requirements, architecture, design, or code artifacts early in development
35+
* Establishing a culture of quality and shared code ownership in teams
36+
* When you want measurable, process-level quality improvement over time
37+
* Regulated environments (medical devices, avionics, finance) requiring documented review evidence
38+
39+
[discrete]
40+
== Related Anchors:
41+
42+
* <<mutation-testing,Mutation Testing>>
43+
* <<testing-pyramid,Testing Pyramid>>
44+
====
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
= Fagan-Inspektion
2+
:categories: testing-quality
3+
:roles: software-developer, qa-engineer, software-architect, team-lead
4+
:related: mutation-testing, testing-pyramid
5+
:proponents: Michael Fagan
6+
:tags: code-review, inspection, defect-detection, formal-review, static-analysis
7+
:tier: 3
8+
9+
[%collapsible]
10+
====
11+
Auch bekannt als:: Formale Code-Inspektion, Software-Inspektion, Fagan's Inspektionsmethode
12+
13+
[discrete]
14+
== Kernkonzepte:
15+
16+
Formaler Inspektionsprozess:: Ein strukturierter, mehrphasiger Prüfprozess für Software-Artefakte (Anforderungen, Design, Code) mit definierten Rollen und Ein-/Ausstiegskriterien
17+
18+
Rollen:: Moderator (leitet und protokolliert), Autor (hat das Artefakt erstellt), Inspektoren (Prüfer), Protokollant (dokumentiert Defekte)
19+
20+
Sechs Phasen:: Planung → Übersicht → Vorbereitung → Inspektionssitzung → Nachbearbeitung → Nachverfolgung
21+
22+
Ein- und Ausstiegskriterien:: Explizite Bedingungen, die vor dem Eintritt in und Austritt aus jeder Phase erfüllt sein müssen, um vorzeitiges Voranschreiten zu verhindern
23+
24+
Fehlerklassifikation:: Fehler werden nach Typ (fehlend, falsch, überflüssig) und Schweregrad kategorisiert, um Prozessverbesserungen durch Ursachenanalyse zu ermöglichen
25+
26+
Kennzahlengetrieben:: Inspektionsdaten (Fehlerrate, Inspektionsrate) werden gesammelt und zur Verbesserung sowohl des Produkts als auch des Inspektionsprozesses genutzt
27+
28+
Schlüsselvertreter:: Michael Fagan ("Design and Code Inspections to Reduce Errors in Program Development", IBM Systems Journal, 1976)
29+
30+
[discrete]
31+
== Wann zu verwenden:
32+
33+
* Sicherheitskritische oder qualitätsintensive Software, bei der das Entweichen von Fehlern kostspielig ist
34+
* Frühe Überprüfung von Anforderungen, Architektur, Design oder Code-Artefakten
35+
* Aufbau einer Qualitätskultur und gemeinsamen Code-Verantwortung im Team
36+
* Wenn messbare, prozessbasierte Qualitätsverbesserung über die Zeit angestrebt wird
37+
* Regulierte Umgebungen (Medizinprodukte, Luftfahrt, Finanzen), die dokumentierte Prüfnachweise erfordern
38+
39+
[discrete]
40+
== Verwandte Anker:
41+
42+
* <<mutation-testing,Mutation Testing>>
43+
* <<testing-pyramid,Testing Pyramid>>
44+
====

0 commit comments

Comments
 (0)