Skip to content

Commit 120e674

Browse files
authored
Merge branch 'main' into copilot/add-atam-anchoring-term
2 parents 434d97f + 1427b4d commit 120e674

8 files changed

Lines changed: 151 additions & 10 deletions

File tree

docs/all-anchors.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,8 @@ include::anchors/gom.adoc[leveloffset=+2]
117117

118118
include::anchors/hexagonal-architecture.adoc[leveloffset=+2]
119119

120+
include::anchors/lasr.adoc[leveloffset=+2]
121+
120122
include::anchors/madr.adoc[leveloffset=+2]
121123

122124
<<<

docs/anchors/lasr.adoc

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
= LASR according to Toth/Zörner
2+
:categories: software-architecture
3+
:roles: software-architect, software-developer, technical-writer, team-lead, consultant
4+
:related: arc42, adr-according-to-nygard, c4-diagrams
5+
:proponents: Stefan Toth, Stefan Zörner
6+
:tags: architecture-documentation, solution-strategy, interfaces, risks, lightweight, communication
7+
8+
[%collapsible]
9+
====
10+
Full Name:: LASR – Lightweight Architecture Documentation by Toth/Zörner
11+
12+
Also known as:: Lightweight Architecture Communication, LASR Template
13+
14+
[discrete]
15+
== *Core Concepts*:
16+
17+
L – Lösungsstrategie (Solution Strategy):: High-level description of how the solution addresses the most important quality requirements and constraints; the central architectural ideas that shape the system
18+
19+
A – Architekturüberblick (Architecture Overview):: Key structural and runtime views showing the main building blocks, their responsibilities, and how they interact at runtime
20+
21+
S – Schnittstellen (Interfaces):: Definition of all relevant external interfaces (APIs, protocols, data formats) and important internal interfaces between major components
22+
23+
R – Risiken (Risks):: Identification of the most critical technical risks, open questions, and known weaknesses together with proposed mitigation strategies
24+
25+
Lightweight by design:: LASR intentionally focuses on the four most communication-relevant aspects of an architecture, omitting detail that does not aid stakeholder understanding
26+
27+
Living document:: Updated alongside the architecture; meant to communicate current state, not archive history
28+
29+
Key Proponents:: Stefan Toth ("Vorgehensmuster für Softwarearchitektur"), Stefan Zörner ("Softwarearchitekturen dokumentieren und kommunizieren")
30+
31+
[discrete]
32+
== *When to Use*:
33+
34+
* Communicating architecture to stakeholders who need a concise overview rather than full documentation
35+
* Agile projects where a lightweight alternative to arc42 is preferred
36+
* Architecture reviews where the four LASR aspects serve as a structured review checklist
37+
* Onboarding new team members to an existing system's key design decisions
38+
* Workshops where teams collaboratively capture the essential architecture decisions
39+
40+
[discrete]
41+
== *Related Anchors*:
42+
43+
* <<arc42,arc42 Architecture Documentation>>
44+
* <<adr-according-to-nygard,ADR according to Nygard>>
45+
* <<c4-diagrams,C4 Diagrams>>
46+
====

docs/anchors/lasr.de.adoc

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
= LASR nach Toth/Zörner
2+
:categories: software-architecture
3+
:roles: software-architect, software-developer, technical-writer, team-lead, consultant
4+
:related: arc42, adr-according-to-nygard, c4-diagrams
5+
:proponents: Stefan Toth, Stefan Zörner
6+
:tags: architecture-documentation, solution-strategy, interfaces, risks, lightweight, communication
7+
8+
[%collapsible]
9+
====
10+
Vollständiger Name:: LASR – Leichtgewichtige Architekturdokumentation nach Toth/Zörner
11+
12+
Auch bekannt als:: Leichtgewichtige Architekturkommunikation, LASR-Template
13+
14+
[discrete]
15+
== *Kernkonzepte*:
16+
17+
L – Lösungsstrategie:: Übergeordnete Beschreibung, wie die Lösung die wichtigsten Qualitätsanforderungen und Randbedingungen adressiert; die zentralen Architekturideen, die das System prägen
18+
19+
A – Architekturüberblick:: Wesentliche Struktur- und Laufzeitsichten mit den wichtigsten Bausteinen, deren Verantwortlichkeiten und ihrer Interaktion zur Laufzeit
20+
21+
S – Schnittstellen:: Definition aller relevanten Außenschnittstellen (APIs, Protokolle, Datenformate) sowie wichtiger interner Schnittstellen zwischen den Hauptkomponenten
22+
23+
R – Risiken:: Identifikation der kritischsten technischen Risiken, offener Fragen und bekannter Schwächen zusammen mit vorgeschlagenen Maßnahmen zur Risikoreduzierung
24+
25+
Bewusst leichtgewichtig:: LASR konzentriert sich gezielt auf die vier kommunikationsrelevantesten Aspekte einer Architektur und verzichtet auf Details, die das Stakeholder-Verständnis nicht verbessern
26+
27+
Lebendes Dokument:: Wird parallel zur Architektur aktualisiert; dient der Kommunikation des aktuellen Stands, nicht der Archivierung von Geschichte
28+
29+
Schlüsselvertreter:: Stefan Toth ("Vorgehensmuster für Softwarearchitektur"), Stefan Zörner ("Softwarearchitekturen dokumentieren und kommunizieren")
30+
31+
[discrete]
32+
== *Wann zu verwenden*:
33+
34+
* Kommunikation der Architektur an Stakeholder, die einen prägnanten Überblick statt vollständiger Dokumentation benötigen
35+
* Agile Projekte, in denen eine leichtgewichtige Alternative zu arc42 bevorzugt wird
36+
* Architektur-Reviews, bei denen die vier LASR-Aspekte als strukturierte Review-Checkliste dienen
37+
* Einarbeitung neuer Teammitglieder in die wesentlichen Entwurfsentscheidungen eines bestehenden Systems
38+
* Workshops, in denen Teams gemeinsam die wesentlichen Architekturentscheidungen erfassen
39+
40+
[discrete]
41+
== *Verwandte Anker*:
42+
43+
* <<arc42,arc42 Architekturdokumentation>>
44+
* <<adr-according-to-nygard,ADR nach Nygard>>
45+
* <<c4-diagrams,C4-Diagramme>>
46+
====

docs/metadata/roles.yml

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,15 @@ hexagonal-architecture:
104104
- software-developer
105105
rationale: "Architectural pattern; architects design, developers implement ports/adapters"
106106

107+
lasr:
108+
roles:
109+
- software-architect
110+
- software-developer
111+
- technical-writer
112+
- team-lead
113+
- consultant
114+
rationale: "Lightweight architecture documentation; architects create LASR docs, developers contribute interface and risk sections, tech writers format, team leads use for onboarding, consultants teach the approach"
115+
107116
clean-architecture:
108117
roles:
109118
- software-architect
@@ -386,17 +395,17 @@ feynman-technique:
386395

387396
# SUMMARY STATISTICS
388397

389-
# Total anchors mapped: 50
398+
# Total anchors mapped: 51
390399
#
391400
# Roles by frequency:
392-
# - software-developer: 25 anchors (50%)
393-
# - team-lead: 21 anchors (42%)
394-
# - software-architect: 18 anchors (36%)
395-
# - consultant: 16 anchors (32%)
396-
# - qa-engineer: 14 anchors (28%)
397-
# - business-analyst: 13 anchors (26%)
401+
# - software-developer: 26 anchors (51%)
402+
# - team-lead: 22 anchors (43%)
403+
# - software-architect: 19 anchors (37%)
404+
# - consultant: 17 anchors (33%)
405+
# - qa-engineer: 14 anchors (27%)
406+
# - business-analyst: 13 anchors (25%)
398407
# - devops-engineer: 10 anchors (20%)
399-
# - technical-writer: 9 anchors (18%)
408+
# - technical-writer: 10 anchors (20%)
400409
# - product-owner: 8 anchors (16%)
401410
# - data-scientist: 7 anchors (14%)
402411
# - educator: 7 anchors (14%)

website/public/data/anchors.json

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -512,6 +512,38 @@
512512
"tags": [],
513513
"filePath": "docs/anchors/jobs-to-be-done.adoc"
514514
},
515+
{
516+
"id": "lasr",
517+
"title": "LASR by Toth/Zörner",
518+
"categories": [
519+
"software-architecture"
520+
],
521+
"roles": [
522+
"software-architect",
523+
"software-developer",
524+
"technical-writer",
525+
"team-lead",
526+
"consultant"
527+
],
528+
"related": [
529+
"arc42",
530+
"adr-according-to-nygard",
531+
"c4-diagrams"
532+
],
533+
"proponents": [
534+
"Stefan Toth",
535+
"Stefan Zörner"
536+
],
537+
"tags": [
538+
"architecture-documentation",
539+
"solution-strategy",
540+
"interfaces",
541+
"risks",
542+
"lightweight",
543+
"communication"
544+
],
545+
"filePath": "docs/anchors/lasr.adoc"
546+
},
515547
{
516548
"id": "madr",
517549
"title": "MADR",
@@ -1064,4 +1096,4 @@
10641096
"tags": [],
10651097
"filePath": "docs/anchors/what-qualifies-as-a-semantic-anchor.adoc"
10661098
}
1067-
]
1099+
]

website/public/data/categories.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,6 +90,7 @@
9090
"domain-driven-design",
9191
"gom",
9292
"hexagonal-architecture",
93+
"lasr",
9394
"madr"
9495
]
9596
},

website/public/data/metadata.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
"roles": 12
88
},
99
"statistics": {
10-
"averageRolesPerAnchor": "3.33",
10+
"averageRolesPerAnchor": "3.36",
1111
"averageCategoriesPerAnchor": "1.00",
1212
"anchorsWithTags": 10,
1313
"anchorsWithRelated": 9

website/public/data/roles.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,7 @@
3333
"gom",
3434
"iec-61508-sil-levels",
3535
"impact-mapping",
36+
"lasr",
3637
"mece",
3738
"mental-model-according-to-naur",
3839
"morphological-box",
@@ -146,6 +147,7 @@
146147
"gom",
147148
"hexagonal-architecture",
148149
"iec-61508-sil-levels",
150+
"lasr",
149151
"madr",
150152
"mece",
151153
"morphological-box",
@@ -177,6 +179,7 @@
177179
"fowler-patterns",
178180
"hexagonal-architecture",
179181
"iec-61508-sil-levels",
182+
"lasr",
180183
"madr",
181184
"mental-model-according-to-naur",
182185
"morphological-box",
@@ -215,6 +218,7 @@
215218
"fowler-patterns",
216219
"gom",
217220
"impact-mapping",
221+
"lasr",
218222
"madr",
219223
"mental-model-according-to-naur",
220224
"moscow",
@@ -240,6 +244,7 @@
240244
"diataxis-framework",
241245
"docs-as-code",
242246
"ears-requirements",
247+
"lasr",
243248
"pyramid-principle",
244249
"todotxt-flavoured-markdown"
245250
]

0 commit comments

Comments
 (0)