Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/anchors/4mat.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,11 @@ Key Proponents:: Bernice McCarthy ("The 4MAT System: Teaching to Learning Styles
* <<pyramid-principle,Pyramid Principle>> - Top-down structure for written communication; complements 4MAT which is experience-first
* <<feynman-technique,Feynman Technique>> - Self-directed learning; 4MAT is teacher-directed instructional design
* <<diataxis-framework,Diátaxis Framework>> - Documentation types (tutorial/how-to/reference/explanation) map loosely to 4MAT quadrants

[discrete]
== *Criticism*:

* 4MAT rests on learning-styles theory, and the matching claim lacks empirical support: Pashler, McDaniel, Rohrer & Bjork, https://doi.org/10.1111/j.1539-6053.2009.01038.x["Learning Styles: Concepts and Evidence"] (Psychological Science in the Public Interest, 2008) found virtually no valid evidence that teaching matched to a diagnosed learning style improves outcomes
* Paul Kirschner, https://doi.org/10.1016/j.compedu.2016.12.006["Stop propagating the learning styles myth"] (Computers & Education, 2017) — nearly all studies claiming supporting evidence fail basic criteria of scientific validity
* The common defense: 4MAT's Why/What/How/What-If cycle works as a lesson-*sequencing* device that every learner moves through — a reading that survives even when the underlying learning-styles claim is dropped
====
7 changes: 7 additions & 0 deletions docs/anchors/4mat.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,11 @@ Schlüsselvertreter:: Bernice McCarthy ("The 4MAT System: Teaching to Learning S
* <<pyramid-principle,Pyramid Principle>> - Top-down-Struktur für schriftliche Kommunikation; ergänzt 4MAT, das erfahrungsorientiert beginnt
* <<feynman-technique,Feynman Technique>> - Selbstgesteuertes Lernen; 4MAT ist lehrergesteuertes Instruktionsdesign
* <<diataxis-framework,Diátaxis Framework>> - Dokumentationstypen (Tutorial/How-to/Reference/Explanation) entsprechen grob den 4MAT-Quadranten

[discrete]
== *Kritik*:

* 4MAT fußt auf der Lernstil-Theorie, und deren Matching-These ist empirisch nicht gedeckt: Pashler, McDaniel, Rohrer & Bjork, https://doi.org/10.1111/j.1539-6053.2009.01038.x["Learning Styles: Concepts and Evidence"] (Psychological Science in the Public Interest, 2008) fanden praktisch keine validen Belege, dass auf diagnostizierte Lernstile zugeschnittener Unterricht die Ergebnisse verbessert
* Paul Kirschner, https://doi.org/10.1016/j.compedu.2016.12.006["Stop propagating the learning styles myth"] (Computers & Education, 2017) — fast alle Studien mit angeblichen Belegen scheitern an grundlegenden Kriterien wissenschaftlicher Validität
* Die übliche Verteidigung: Der Why/What/How/What-If-Zyklus von 4MAT funktioniert als *Sequenzierungs*-Werkzeug, das jeder Lernende durchläuft — eine Lesart, die auch ohne die Lernstil-These trägt
====
7 changes: 7 additions & 0 deletions docs/anchors/aida-model.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,11 @@ Key Proponents:: Commonly attributed to E. St. Elmo Lewis (1898), an American ad
* <<inverted-pyramid-style,Inverted Pyramid Style>> - News structure front-loads the full story; AIDA deliberately withholds the ask until Desire is built
* <<pyramid-principle,Pyramid Principle>> - Logical top-down argument for clarity; AIDA is an emotional persuasion sequence for conversion
* <<bluf,BLUF (Bottom Line Up Front)>> - Leads with the conclusion; the opposite move to AIDA, which earns the conclusion across four stages

[discrete]
== *Criticism*:

* Robert Heath & Paul Feldwick, https://researchportal.bath.ac.uk/en/publications/fifty-years-using-the-wrong-model-of-advertising["Fifty years using the wrong model of advertising"] (International Journal of Market Research, 2008) — the rational, sequential persuasion model behind AIDA misrepresents how advertising actually works: largely through emotional, low-attention processing rather than attentive information processing
* Demetrios Vakratsas & Tim Ambler, https://doi.org/10.1177/002224299906300103["How Advertising Works: What Do We Really Know?"] (Journal of Marketing, 1999) — reviewing over 250 studies, they found little empirical support for any fixed hierarchy of effects and recommended abandoning the hierarchy concept as a planning assumption
* The model's age is part of the critique: AIDA originates around 1898, pre-dating formal marketing science, yet still dominates campaign planning — precisely the persistence Heath and Feldwick criticize
====
7 changes: 7 additions & 0 deletions docs/anchors/aida-model.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,11 @@ Key Proponents:: Üblicherweise E. St. Elmo Lewis (1898) zugeschrieben, einem am
* <<inverted-pyramid-style,Inverted Pyramid Style>> - Die News-Struktur stellt die ganze Story nach vorn; AIDA hält den Aufruf bewusst zurück, bis Desire aufgebaut ist
* <<pyramid-principle,Pyramid Principle>> - Logisches Top-down-Argument für Klarheit; AIDA ist eine emotionale Überzeugungssequenz für Conversion
* <<bluf,BLUF (Bottom Line Up Front)>> - Beginnt mit dem Fazit; der Gegenzug zu AIDA, das das Fazit über vier Stufen erarbeitet

[discrete]
== *Kritik*:

* Robert Heath & Paul Feldwick, https://researchportal.bath.ac.uk/en/publications/fifty-years-using-the-wrong-model-of-advertising["Fifty years using the wrong model of advertising"] (International Journal of Market Research, 2008) — das rationale, sequenzielle Überzeugungsmodell hinter AIDA verzerrt, wie Werbung tatsächlich wirkt: großteils über emotionale Verarbeitung bei niedriger Aufmerksamkeit statt über aufmerksame Informationsverarbeitung
* Demetrios Vakratsas & Tim Ambler, https://doi.org/10.1177/002224299906300103["How Advertising Works: What Do We Really Know?"] (Journal of Marketing, 1999) — in der Auswertung von über 250 Studien fanden sie kaum empirische Belege für irgendeine feste Wirkungshierarchie und empfahlen, das Hierarchie-Konzept als Planungsannahme aufzugeben
* Das Alter des Modells ist Teil der Kritik: AIDA stammt von etwa 1898, vor der formalen Marketingwissenschaft — und dominiert dennoch die Kampagnenplanung; genau diese Beharrungskraft kritisieren Heath und Feldwick
====
7 changes: 7 additions & 0 deletions docs/anchors/clean-architecture.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -38,4 +38,11 @@ Key Proponent:: Robert C. Martin ("Uncle Bob")
* Systems requiring long-term maintainability
* When team size and turnover are high
* Projects where business rules must be protected from technology changes

[discrete]
== *Criticism*:

* Jimmy Bogard, https://www.jimmybogard.com/vertical-slice-architecture/["Vertical Slice Architecture"] (2018) — calls the "traditional layered/onion/clean architecture" monolithic in its approach and appropriate for only a minority of requests, criticizing mock-heavy tests and abstractions "around concepts that really shouldn't be abstracted"; his alternative is <<vertical-slice-architecture,Vertical Slice Architecture>>
* Derek Comartin, https://codeopinion.com/clean-architecture-and-indirection-no-thanks/["'Clean Architecture' and indirection. No thanks."] (CodeOpinion) — dismisses canonical Clean Architecture examples as "useless indirection": the layering adds cost without paying for itself in typical systems
* The critiques converge: the dependency rule imposes a fixed indirection tax on every feature, while most changes cut across all layers anyway — the coupling Vertical Slice Architecture organizes around instead
====
7 changes: 7 additions & 0 deletions docs/anchors/clean-architecture.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -37,4 +37,11 @@ Schlüsselvertreter:: Robert C. Martin ("Uncle Bob")
* Systeme, die langfristige Wartbarkeit erfordern
* Wenn Teamgröße und Fluktuation hoch sind
* Projekte, bei denen Geschäftsregeln vor Technologieänderungen geschützt werden müssen

[discrete]
== *Kritik*:

* Jimmy Bogard, https://www.jimmybogard.com/vertical-slice-architecture/["Vertical Slice Architecture"] (2018) — nennt die "traditionelle Layered/Onion/Clean Architecture" monolithisch im Ansatz und nur für eine Minderheit der Requests angemessen; er kritisiert mock-lastige Tests und Abstraktionen "um Konzepte, die nicht abstrahiert gehören"; seine Alternative ist <<vertical-slice-architecture,Vertical Slice Architecture>>
* Derek Comartin, https://codeopinion.com/clean-architecture-and-indirection-no-thanks/["'Clean Architecture' and indirection. No thanks."] (CodeOpinion) — tut kanonische Clean-Architecture-Beispiele als "nutzlose Indirektion" ab: Die Schichtung kostet, ohne sich in typischen Systemen zu bezahlen
* Die Kritiken laufen zusammen: Die Dependency Rule erhebt auf jedes Feature eine fixe Indirektions-Steuer, während die meisten Änderungen ohnehin durch alle Schichten schneiden — genau die Kopplung, um die Vertical Slice Architecture stattdessen organisiert
====
7 changes: 7 additions & 0 deletions docs/anchors/cqrs.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,11 @@ Key Proponents:: Greg Young (coined CQRS), Bertrand Meyer (CQS origin, "Object-O
* <<domain-driven-design,Domain-Driven Design>> - Often combined with CQRS for complex domains
* <<hexagonal-architecture,Hexagonal Architecture>> - Ports and adapters complement CQRS separation
* <<fowler-patterns,Fowler Patterns>> - CQRS builds on enterprise application patterns

[discrete]
== *Criticism*:

* Martin Fowler, https://martinfowler.com/bliki/CQRS.html[bliki: CQRS] — warns that "for most systems CQRS adds risky complexity", a "significant mental leap" that pays off only in specific bounded contexts, not as a default pattern
* Udi Dahan, one of CQRS's main proponents, opens https://udidahan.com/2011/04/22/when-to-avoid-cqrs/["When to avoid CQRS"] (2011) with "Most people using CQRS (and Event Sourcing too) shouldn't have done so" — and adds that CQRS "should not be your top-level architectural pattern"
* Greg Young himself pushed back on scope creep in https://web.archive.org/web/20121129063556/http://codebetter.com/gregyoung/2012/09/09/cqrs-is-not-an-architecture-2/["CQRS is not an Architecture"] (2012, archived): CQRS is a pattern applied inside a single component, not an architectural style for a whole system
====
7 changes: 7 additions & 0 deletions docs/anchors/cqrs.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -46,4 +46,11 @@ Schlüsselvertreter:: Greg Young (prägte CQRS), Bertrand Meyer (CQS-Ursprung, "
* <<domain-driven-design,Domain-Driven Design>> - Wird oft mit CQRS für komplexe Domänen kombiniert
* <<hexagonal-architecture,Hexagonal Architecture>> - Ports und Adapter ergänzen die CQRS-Trennung
* <<fowler-patterns,Fowler Patterns>> - CQRS baut auf Enterprise-Application-Patterns auf

[discrete]
== *Kritik*:

* Martin Fowler, https://martinfowler.com/bliki/CQRS.html[bliki: CQRS] — warnt, dass "CQRS für die meisten Systeme riskante Komplexität hinzufügt", ein "erheblicher mentaler Sprung", der sich nur in bestimmten Bounded Contexts auszahlt, nicht als Default-Pattern
* Udi Dahan, einer der Hauptvertreter von CQRS, eröffnet https://udidahan.com/2011/04/22/when-to-avoid-cqrs/["When to avoid CQRS"] (2011) mit "Most people using CQRS (and Event Sourcing too) shouldn't have done so" — und ergänzt, CQRS "sollte nicht dein Top-Level-Architekturpattern sein"
* Greg Young selbst trat dem Scope Creep entgegen in https://web.archive.org/web/20121129063556/http://codebetter.com/gregyoung/2012/09/09/cqrs-is-not-an-architecture-2/["CQRS is not an Architecture"] (2012, archiviert): CQRS ist ein Pattern innerhalb einer einzelnen Komponente, kein Architekturstil für ein ganzes System
====
7 changes: 7 additions & 0 deletions docs/anchors/dry.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,11 @@ Key Proponents:: Andy Hunt & Dave Thomas, *The Pragmatic Programmer* (1999)
* <<single-level-of-abstraction-principle,Single Level of Abstraction Principle>> — keeps extracted abstractions coherent
* <<kiss-principle,KISS Principle>> — the simplicity counterweight to over-abstraction
* <<yagni,YAGNI>> — don't build the abstraction until you actually need it

[discrete]
== *Criticism*:

* Sandi Metz, https://sandimetz.com/blog/2016/1/20/the-wrong-abstraction["The Wrong Abstraction"] (2016) — overzealous DRY produces abstractions that later requirements don't fit: "duplication is far cheaper than the wrong abstraction"; her advice is to re-introduce the duplication until the right abstraction reveals itself
* The authors themselves concede the principle is widely misread: in the 20th Anniversary Edition (2019), Thomas & Hunt write they "did a poor job of explaining" DRY — it targets duplication of *knowledge and intent*; code deduplication is "a tiny and fairly trivial part" (https://media.pragprog.com/titles/tpp20/dry.pdf[official chapter extract])
* The corollary both critiques share: two pieces of code that look alike but encode different business knowledge are not a DRY violation — merging them creates coupling, not clarity
====
7 changes: 7 additions & 0 deletions docs/anchors/dry.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,11 @@ Key Proponents:: Andy Hunt & Dave Thomas, *The Pragmatic Programmer* (1999)
* <<single-level-of-abstraction-principle,Single Level of Abstraction Principle>> — hält extrahierte Abstraktionen kohärent
* <<kiss-principle,KISS Principle>> — das Einfachheits-Gegengewicht zur Über-Abstraktion
* <<yagni,YAGNI>> — die Abstraktion erst bauen, wenn sie wirklich gebraucht wird

[discrete]
== *Kritik*:

* Sandi Metz, https://sandimetz.com/blog/2016/1/20/the-wrong-abstraction["The Wrong Abstraction"] (2016) — übereifriges DRY erzeugt Abstraktionen, in die spätere Anforderungen nicht passen: "duplication is far cheaper than the wrong abstraction"; ihr Rat: die Duplizierung wieder einführen, bis sich die richtige Abstraktion zeigt
* Die Autoren selbst räumen ein, dass das Prinzip breit missverstanden wird: In der 20th Anniversary Edition (2019) schreiben Thomas & Hunt, sie hätten DRY ursprünglich "schlecht erklärt" — es zielt auf Duplizierung von *Wissen und Absicht*; Code-Deduplizierung ist "ein winziger und ziemlich trivialer Teil" (https://media.pragprog.com/titles/tpp20/dry.pdf[offizieller Kapitelauszug])
* Die Folgerung beider Kritiken: Zwei Code-Stücke, die gleich aussehen, aber unterschiedliches Fachwissen kodieren, sind keine DRY-Verletzung — sie zu verschmelzen erzeugt Kopplung, nicht Klarheit
====
7 changes: 7 additions & 0 deletions docs/anchors/freytags-pyramid.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -45,4 +45,11 @@ Key Proponents:: Gustav Freytag ("Die Technik des Dramas", 1863); John Yorke ("I
* <<heros-journey,Hero's Journey (Monomyth)>>
* <<fichtean-curve,Fichtean Curve>>
* <<save-the-cat,Save the Cat! (15-Beat Sheet)>>

[discrete]
== *Criticism*:

* Novelist and writing professor Jane Alison (_Meander, Spiral, Explode_, 2019; https://www.craftliterary.com/2019/04/23/alison-meander-spiral-explode/[excerpt at CRAFT]) objects that the pyramid was never a general theory of stories — "Novels didn't exist for Aristotle and weren't Freytag's subject" — calls the swell-climax-collapse arc "masculo-sexual", and proposes waves, meanders, and spirals as equally valid narrative designs
* Freytag derived the model from five-act stage tragedy, not narrative in general; Chris Winkle (https://mythcreants.com/blog/freytags-pyramid-is-outdated-heres-what-to-do-instead/[Mythcreants, 2024]) argues it "isn't really applicable to modern stories"
* Defenders such as TD Storm (https://stormwritingschool.com/freytags-pyramid/[Storm Writing School]) counter that, read as Freytag intended — an analysis of classical drama — it is a descriptive lens; the criticism properly targets its later misuse as a universal template
====
7 changes: 7 additions & 0 deletions docs/anchors/freytags-pyramid.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -33,4 +33,11 @@ Schlüsselvertreter:: Gustav Freytag ("Die Technik des Dramas", 1863); John York
* Diagnose, ob der Höhepunkt einer Geschichte am richtigen Punkt positioniert ist
* Schreiben von Tragödien oder dramatischer Belletristik, bei der der Fehler des Protagonisten den Zusammenbruch antreibt
* Verstehen, warum Akt 2 / aufsteigende Handlung sich träge anfühlt — er muss eskalierender Komplikationen, keine Füllmaterialien enthalten

[discrete]
== *Kritik*:

* Die Romanautorin und Schreibprofessorin Jane Alison (_Meander, Spiral, Explode_, 2019; https://www.craftliterary.com/2019/04/23/alison-meander-spiral-explode/[Auszug bei CRAFT]) wendet ein, die Pyramide sei nie eine allgemeine Erzähltheorie gewesen — "Novels didn't exist for Aristotle and weren't Freytag's subject" — nennt den Anstieg-Höhepunkt-Kollaps-Bogen "masculo-sexual" und schlägt Wellen, Mäander und Spiralen als ebenso gültige Erzählmuster vor
* Freytag leitete das Modell aus der fünfaktigen Bühnentragödie ab, nicht aus Erzählung im Allgemeinen; Chris Winkle (https://mythcreants.com/blog/freytags-pyramid-is-outdated-heres-what-to-do-instead/[Mythcreants, 2024]) hält es für "auf moderne Geschichten kaum anwendbar"
* Verteidiger wie TD Storm (https://stormwritingschool.com/freytags-pyramid/[Storm Writing School]) halten dagegen: Gelesen wie von Freytag gemeint — als Analyse des klassischen Dramas — ist es eine beschreibende Linse; die Kritik trifft zu Recht den späteren Missbrauch als Universalschablone
====
7 changes: 7 additions & 0 deletions docs/anchors/gof-design-patterns.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,11 @@ Key Proponents:: Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides ("Desi
* <<solid-principles,SOLID Principles>> - Design principles that GoF patterns help implement
* <<fowler-patterns,Fowler Patterns>> - Enterprise application architecture patterns (complementary scope)
* <<clean-architecture,Clean Architecture>> - Architectural style leveraging GoF principles

[discrete]
== *Criticism*:

* Peter Norvig, https://norvig.com/design-patterns/["Design Patterns in Dynamic Languages"] (1996/1998) — 16 of the 23 patterns have a "qualitatively simpler implementation" in Lisp or Dylan than in C++, or vanish into the language entirely: many patterns compensate for missing language features rather than capture universal design wisdom
* Paul Graham, https://www.paulgraham.com/icad.html["Revenge of the Nerds"] (2002) — recurring patterns may be evidence of "the human compiler at work": "When I see patterns in my programs, I consider it a sign of trouble", a sign the language's abstractions are not powerful enough
* The authors themselves treat the catalog as a 1994 snapshot, not a closed canon: in the https://www.informit.com/articles/article.aspx?p=1404056[2009 InformIT interview] they discuss how they would reorganize and trim it today (see also the Criticism on <<gof-singleton-pattern,Singleton>>)
Comment on lines +54 to +56

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Fetch the Paul Graham essay and check for the exact quote

curl -s "https://www.paulgraham.com/icad.html" | grep -i "patterns" | head -20

Repository: LLM-Coding/Semantic-Anchors

Length of output: 330


Paul-Graham-Zitat ist in der Quelle wortgetreu vorhanden — Auf https://www.paulgraham.com/icad.html steht der Satz „When I see patterns in my programs, I consider it a sign of trouble“ (im Original mit abschließendem Punkt); in docs/anchors/gof-design-patterns.adoc ggf. die Interpunktion (Punkt am Satzende) innerhalb der Anführungszeichen konsistent übernehmen.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/anchors/gof-design-patterns.adoc` around lines 54 - 56, Die zitierte
Paul-Graham-Textstelle "When I see patterns in my programs, I consider it a sign
of trouble" fehlt der abschließende Punkt; suche die Zeichenkette genau so in
der Datei (die Zeile mit dem Zitat) und füge den Punkt innerhalb der
Anführungszeichen hinzu, sodass das Zitat exakt mit "..." endet; prüfe außerdem
benachbarte Vorkommen desselben Zitats und passe sie konsistent an (siehe auch
den Kontextmarker <<gof-singleton-pattern,Singleton>> zur Lokalisierung).

====
7 changes: 7 additions & 0 deletions docs/anchors/gof-design-patterns.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -46,4 +46,11 @@ Schlüsselvertreter:: Erich Gamma, Richard Helm, Ralph Johnson, John Vlissides (
* <<solid-principles,SOLID Principles>> - Entwurfsprinzipien, deren Umsetzung GoF-Patterns unterstützen
* <<fowler-patterns,Fowler Patterns>> - Architekturmuster für Unternehmensanwendungen (komplementärer Umfang)
* <<clean-architecture,Clean Architecture>> - Architekturstil, der GoF-Prinzipien nutzt

[discrete]
== *Kritik*:

* Peter Norvig, https://norvig.com/design-patterns/["Design Patterns in Dynamic Languages"] (1996/1998) — 16 der 23 Patterns haben in Lisp oder Dylan eine "qualitativ einfachere Implementierung" als in C++ oder verschwinden ganz in der Sprache: Viele Patterns kompensieren fehlende Sprachfeatures, statt universelle Designweisheit festzuhalten
* Paul Graham, https://www.paulgraham.com/icad.html["Revenge of the Nerds"] (2002) — wiederkehrende Patterns können Belege für den "menschlichen Compiler bei der Arbeit" sein: "When I see patterns in my programs, I consider it a sign of trouble" — ein Zeichen, dass die Abstraktionen der Sprache nicht mächtig genug sind
* Die Autoren selbst behandeln den Katalog als Momentaufnahme von 1994, nicht als geschlossenen Kanon: Im https://www.informit.com/articles/article.aspx?p=1404056[InformIT-Interview von 2009] diskutieren sie, wie sie ihn heute umbauen und kürzen würden (siehe auch die Kritik bei <<gof-singleton-pattern,Singleton>>)
====
Loading
Loading