Skip to content

Commit 01e15d1

Browse files
authored
Merge pull request #607 from raifdmueller/feat/603-current-status-batch4
feat: Current Status for remaining 20 anchors, LASR rewrite — triage complete (batch 4 of #603)
2 parents 58e0337 + 8c32ada commit 01e15d1

43 files changed

Lines changed: 289 additions & 44 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/about.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,8 @@ Different people using the same semantic anchor will get *similar, predictable r
8181

8282
Not every term makes a good semantic anchor. We maintain high quality standards:
8383

84+
*Inclusion means precision, not endorsement.* The catalog is a lexicon: an anchor's presence means the term works as a precise pointer to a dense, well-documented concept — not that we recommend the practice. Where a method is contested or its current edition has drifted away from the training-data prior, the anchor says so in a _Criticism_ or _Current Status_ section with named, linked sources.
85+
8486
=== Precise
8587
References a *specific, established body of knowledge* with clear boundaries.
8688

docs/about.de.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,8 @@ Verschiedene Personen, die denselben semantischen Anker verwenden, erhalten *äh
110110

111111
Nicht jeder Begriff eignet sich als semantischer Anker. Wir pflegen hohe Qualitätsstandards:
112112

113+
*Aufnahme bedeutet Präzision, nicht Empfehlung.* Der Katalog ist ein Begriffslexikon: Dass ein Anker enthalten ist, heißt, der Begriff funktioniert als präziser Pointer auf ein dichtes, gut dokumentiertes Konzept — nicht, dass wir die Praxis empfehlen. Wo eine Methode umstritten ist oder ihre aktuelle Edition vom Trainingsdaten-Prior abgedriftet ist, sagt der Anker das in einer _Kritik_- oder _Aktueller-Stand_-Sektion mit benannten, verlinkten Quellen.
114+
113115
=== Präzise
114116
Referenziert einen *spezifischen, etablierten Wissensbereich* mit klaren Grenzen.
115117

docs/anchors/arc42.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,4 +49,10 @@ Key Proponents:: Gernot Starke, Peter Hruschka
4949
* Medium to large software projects
5050
* When stakeholder communication is critical
5151
* Long-lived systems requiring maintainability
52+
53+
[discrete]
54+
== *Current Status*:
55+
56+
* The current release is template version https://arc42.org/download[9.0] (July 2025); the 12-section structure has been stable for many years — v9's main change splits Section 10 into a quality-requirements overview (10.1) and detailed scenarios (10.2)
57+
* What evolves is the material around the skeleton: help texts, translations, the tips-and-examples site https://docs.arc42.org/home/[docs.arc42.org], and the https://quality.arc42.org/[arc42 quality model (Q42)] — a prior trained on v7/v8 material knows the section structure correctly but misses the Section-10 split and Q42
5258
====

docs/anchors/arc42.de.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,4 +49,10 @@ Schlüsselvertreter:: Gernot Starke, Peter Hruschka
4949
* Mittlere bis große Softwareprojekte
5050
* Wenn Stakeholder-Kommunikation kritisch ist
5151
* Langlebige Systeme, die Wartbarkeit erfordern
52+
53+
[discrete]
54+
== *Aktueller Stand*:
55+
56+
* Die aktuelle Version ist Template-Version https://arc42.org/download[9.0] (Juli 2025); die 12-Kapitel-Struktur ist seit vielen Jahren stabil — die Hauptänderung von v9 teilt Kapitel 10 in eine Qualitätsanforderungs-Übersicht (10.1) und detaillierte Szenarien (10.2)
57+
* Was sich entwickelt, ist das Material um das Skelett herum: Hilfetexte, Übersetzungen, die Tipps-und-Beispiele-Site https://docs.arc42.org/home/[docs.arc42.org] und das https://quality.arc42.org/[arc42-Qualitätsmodell (Q42)] — ein auf v7/v8 trainierter Prior kennt die Kapitelstruktur korrekt, verpasst aber den Kapitel-10-Split und Q42
5258
====

docs/anchors/bem-methodology.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,4 +52,9 @@ Key Proponents:: Yandex development team
5252
* Projects where developers need to quickly understand (S)CSS structure
5353
* Component-based architectures (React, Vue, Angular)
5454

55+
[discrete]
56+
== *Current Status*:
57+
58+
* The definition at https://getbem.com/[getbem.com] and https://bem.info/en/methodology/[bem.info] is stable and still accurate — BEM itself is a finished methodology
59+
* Mainstream practice has shifted: https://2024.stateofcss.com/en-US/tools/[State of CSS 2024] shows Tailwind CSS "far ahead of other, more traditional competitors", and the survey no longer even tracks naming methodologies as it did in https://2020.stateofcss.com/en-US/technologies/methodologies/[2020]; CSS Modules, CSS-in-JS, and native scoping/nesting/cascade layers solve by platform the global-namespace problem BEM solved by convention
5560
====

docs/anchors/bem-methodology.de.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,4 +51,9 @@ Schlüsselvertreter:: Yandex Entwicklungsteam
5151
* Projekte, bei denen Entwickler die (S)CSS-Struktur schnell verstehen müssen
5252
* Komponentenbasierte Architekturen (React, Vue, Angular)
5353

54+
[discrete]
55+
== *Aktueller Stand*:
56+
57+
* Die Definition auf https://getbem.com/[getbem.com] und https://bem.info/en/methodology/[bem.info] ist stabil und weiterhin korrekt — BEM selbst ist eine fertige Methodik
58+
* Die Praxis hat sich verschoben: https://2024.stateofcss.com/en-US/tools/[State of CSS 2024] zeigt Tailwind CSS "weit vor den traditionelleren Konkurrenten", und die Umfrage erfasst Naming-Methodologien gar nicht mehr wie noch https://2020.stateofcss.com/en-US/technologies/methodologies/[2020]; CSS Modules, CSS-in-JS und natives Scoping/Nesting/Cascade Layers lösen per Plattform das Global-Namespace-Problem, das BEM per Konvention löste
5459
====

docs/anchors/c4-diagrams.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,4 +35,10 @@ Key Proponent:: Simon Brown
3535
* Onboarding new team members
3636
* Architecture documentation and review
3737
* Replacing or supplementing UML
38+
39+
[discrete]
40+
== *Current Status*:
41+
42+
* The four levels (System Context, Container, Component, Code) and the supporting diagrams (system landscape, dynamic, deployment) are stable; https://c4model.com/[c4model.com] remains actively maintained by Simon Brown with edits into 2026
43+
* In September 2024 the site was rewritten from a single long page into a multi-page reference with new guidance (modelling microservices, queues and topics, a review checklist) — a prior trained on the old one-pager misses this guidance and the sharpened https://c4model.com/tooling[diagramming-vs-modelling] framing around tooling such as Structurizr
3844
====

docs/anchors/c4-diagrams.de.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,4 +34,10 @@ Schlüsselvertreter:: Simon Brown
3434
* Onboarding neuer Teammitglieder
3535
* Architekturdokumentation und -review
3636
* Ersetzen oder Ergänzen von UML
37+
38+
[discrete]
39+
== *Aktueller Stand*:
40+
41+
* Die vier Ebenen (System Context, Container, Component, Code) und die ergänzenden Diagramme (System Landscape, Dynamic, Deployment) sind stabil; https://c4model.com/[c4model.com] wird von Simon Brown aktiv gepflegt, mit Änderungen bis in 2026
42+
* Im September 2024 wurde die Site von einer langen Einzelseite zu einer mehrseitigen Referenz umgebaut, mit neuer Anleitung (Microservices modellieren, Queues und Topics, Review-Checkliste) — ein auf den alten Einseiter trainierter Prior verpasst diese Inhalte und die geschärfte https://c4model.com/tooling[Diagramming-vs-Modelling]-Rahmung rund um Tooling wie Structurizr
3743
====

docs/anchors/chain-of-thought.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,4 +60,10 @@ Let's solve this step by step:
6060
...
6161
Therefore: [Conclusion]
6262
----
63+
64+
[discrete]
65+
== *Current Status*:
66+
67+
* The core finding (Wei et al., https://arxiv.org/abs/2201.11903[NeurIPS 2022]) is stable, but its practical relevance is cutoff-bound: reasoning models (late 2024 onward) internalise chain-of-thought during training — https://platform.openai.com/docs/guides/reasoning-best-practices[OpenAI's own docs] now advise against "think step by step" prompts for those models
68+
* Treat CoT output as a useful but unreliable window into model reasoning: Turpin et al., https://arxiv.org/abs/2305.04388["Language Models Don't Always Say What They Think"] (2023) and https://www.anthropic.com/research/reasoning-models-dont-say-think[Anthropic's 2025 follow-up] show stated reasoning can be unfaithful to the actual decision factors — not a safety or audit guarantee
6369
====

docs/anchors/chain-of-thought.de.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,4 +59,10 @@ Lass uns das Schritt für Schritt lösen:
5959
...
6060
Daher: [Schlussfolgerung]
6161
----
62+
63+
[discrete]
64+
== *Aktueller Stand*:
65+
66+
* Der Kernbefund (Wei et al., https://arxiv.org/abs/2201.11903[NeurIPS 2022]) ist stabil, seine praktische Relevanz aber cutoff-gebunden: Reasoning-Modelle (ab Ende 2024) internalisieren Chain-of-Thought im Training — https://platform.openai.com/docs/guides/reasoning-best-practices[OpenAIs eigene Doku] rät für diese Modelle inzwischen von "think step by step"-Prompts ab
67+
* CoT-Output ist ein nützliches, aber unzuverlässiges Fenster ins Modell-Reasoning: Turpin et al., https://arxiv.org/abs/2305.04388["Language Models Don't Always Say What They Think"] (2023) und https://www.anthropic.com/research/reasoning-models-dont-say-think[Anthropics Follow-up von 2025] zeigen, dass das geäußerte Reasoning den tatsächlichen Entscheidungsfaktoren untreu sein kann — keine Safety- oder Audit-Garantie
6268
====

0 commit comments

Comments
 (0)