-
Notifications
You must be signed in to change notification settings - Fork 25
Add LASR nach Toth/Zörner semantic anchor #136
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 2 commits
Commits
Show all changes
7 commits
Select commit
Hold shift + click to select a range
64cf411
Initial plan
Copilot 30c05a0
feat: Add LASR nach Toth/Zörner semantic anchor (#134)
Copilot 9a9baec
Update docs/anchors/lasr.adoc
rdmueller 8775898
Update website/public/data/anchors.json
rdmueller 425bd89
Correct proponent name from Oliver Zörner to Stefan Zörner
rdmueller a9851ac
Corrected name of key proponent from Oliver to Stefan
rdmueller 3dd3d90
Update proponents list in anchors.json
rdmueller File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| = LASR nach Toth/Zörner | ||
| :categories: software-architecture | ||
| :roles: software-architect, software-developer, technical-writer, team-lead, consultant | ||
| :related: arc42, adr-according-to-nygard, c4-diagrams | ||
| :proponents: Stefan Toth, Oliver Zörner | ||
| :tags: architecture-documentation, solution-strategy, interfaces, risks, lightweight, communication | ||
|
|
||
| [%collapsible] | ||
| ==== | ||
| Full Name:: LASR – Lightweight Architecture Documentation by Toth/Zörner | ||
|
|
||
| Also known as:: Lightweight Architecture Communication, LASR Template | ||
|
|
||
| [discrete] | ||
| == *Core Concepts*: | ||
|
|
||
| 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 | ||
|
|
||
| A – Architekturüberblick (Architecture Overview):: Key structural and runtime views showing the main building blocks, their responsibilities, and how they interact at runtime | ||
|
|
||
| S – Schnittstellen (Interfaces):: Definition of all relevant external interfaces (APIs, protocols, data formats) and important internal interfaces between major components | ||
|
|
||
| R – Risiken (Risks):: Identification of the most critical technical risks, open questions, and known weaknesses together with proposed mitigation strategies | ||
|
|
||
| Lightweight by design:: LASR intentionally focuses on the four most communication-relevant aspects of an architecture, omitting detail that does not aid stakeholder understanding | ||
|
|
||
| Living document:: Updated alongside the architecture; meant to communicate current state, not archive history | ||
|
|
||
| Key Proponents:: Stefan Toth ("Vorgehensmuster für Softwarearchitektur"), Oliver Zörner ("Softwarearchitekturen dokumentieren und kommunizieren") | ||
|
|
||
| [discrete] | ||
| == *When to Use*: | ||
|
|
||
| * Communicating architecture to stakeholders who need a concise overview rather than full documentation | ||
| * Agile projects where a lightweight alternative to arc42 is preferred | ||
| * Architecture reviews where the four LASR aspects serve as a structured review checklist | ||
| * Onboarding new team members to an existing system's key design decisions | ||
| * Workshops where teams collaboratively capture the essential architecture decisions | ||
|
|
||
| [discrete] | ||
| == *Related Anchors*: | ||
|
|
||
| * <<arc42,arc42 Architecture Documentation>> | ||
| * <<adr-according-to-nygard,ADR according to Nygard>> | ||
| * <<c4-diagrams,C4 Diagrams>> | ||
| ==== | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| = LASR nach Toth/Zörner | ||
| :categories: software-architecture | ||
| :roles: software-architect, software-developer, technical-writer, team-lead, consultant | ||
| :related: arc42, adr-according-to-nygard, c4-diagrams | ||
| :proponents: Stefan Toth, Oliver Zörner | ||
| :tags: architecture-documentation, solution-strategy, interfaces, risks, lightweight, communication | ||
|
|
||
| [%collapsible] | ||
| ==== | ||
| Vollständiger Name:: LASR – Leichtgewichtige Architekturdokumentation nach Toth/Zörner | ||
|
|
||
| Auch bekannt als:: Leichtgewichtige Architekturkommunikation, LASR-Template | ||
|
|
||
| [discrete] | ||
| == *Kernkonzepte*: | ||
|
|
||
| L – Lösungsstrategie:: Übergeordnete Beschreibung, wie die Lösung die wichtigsten Qualitätsanforderungen und Randbedingungen adressiert; die zentralen Architekturideen, die das System prägen | ||
|
|
||
| A – Architekturüberblick:: Wesentliche Struktur- und Laufzeitsichten mit den wichtigsten Bausteinen, deren Verantwortlichkeiten und ihrer Interaktion zur Laufzeit | ||
|
|
||
| S – Schnittstellen:: Definition aller relevanten Außenschnittstellen (APIs, Protokolle, Datenformate) sowie wichtiger interner Schnittstellen zwischen den Hauptkomponenten | ||
|
|
||
| R – Risiken:: Identifikation der kritischsten technischen Risiken, offener Fragen und bekannter Schwächen zusammen mit vorgeschlagenen Maßnahmen zur Risikoreduzierung | ||
|
|
||
| Bewusst leichtgewichtig:: LASR konzentriert sich gezielt auf die vier kommunikationsrelevantesten Aspekte einer Architektur und verzichtet auf Details, die das Stakeholder-Verständnis nicht verbessern | ||
|
|
||
| Lebendes Dokument:: Wird parallel zur Architektur aktualisiert; dient der Kommunikation des aktuellen Stands, nicht der Archivierung von Geschichte | ||
|
|
||
| Schlüsselvertreter:: Stefan Toth („Vorgehensmuster für Softwarearchitektur"), Oliver Zörner („Softwarearchitekturen dokumentieren und kommunizieren") | ||
rdmueller marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| [discrete] | ||
| == *Wann zu verwenden*: | ||
|
|
||
| * Kommunikation der Architektur an Stakeholder, die einen prägnanten Überblick statt vollständiger Dokumentation benötigen | ||
| * Agile Projekte, in denen eine leichtgewichtige Alternative zu arc42 bevorzugt wird | ||
| * Architektur-Reviews, bei denen die vier LASR-Aspekte als strukturierte Review-Checkliste dienen | ||
| * Einarbeitung neuer Teammitglieder in die wesentlichen Entwurfsentscheidungen eines bestehenden Systems | ||
| * Workshops, in denen Teams gemeinsam die wesentlichen Architekturentscheidungen erfassen | ||
|
|
||
| [discrete] | ||
| == *Verwandte Anker*: | ||
|
|
||
| * <<arc42,arc42 Architekturdokumentation>> | ||
| * <<adr-according-to-nygard,ADR nach Nygard>> | ||
| * <<c4-diagrams,C4-Diagramme>> | ||
| ==== | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -89,6 +89,7 @@ | |
| "domain-driven-design", | ||
| "gom", | ||
| "hexagonal-architecture", | ||
| "lasr", | ||
| "madr" | ||
| ] | ||
| }, | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,15 +1,15 @@ | ||
| { | ||
| "generatedAt": "2026-03-04T12:59:17.826Z", | ||
| "generatedAt": "2026-03-06T17:54:22.119Z", | ||
| "version": "1.0.0", | ||
| "counts": { | ||
| "anchors": 54, | ||
| "anchors": 55, | ||
| "categories": 12, | ||
| "roles": 12 | ||
| }, | ||
| "statistics": { | ||
| "averageRolesPerAnchor": "3.33", | ||
| "averageRolesPerAnchor": "3.36", | ||
| "averageCategoriesPerAnchor": "1.00", | ||
| "anchorsWithTags": 9, | ||
| "anchorsWithRelated": 8 | ||
| "anchorsWithTags": 10, | ||
| "anchorsWithRelated": 9 | ||
| } | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.