Skip to content

Commit

Permalink
#606-replaced Design-Decisions by Architecture Decisions
Browse files Browse the repository at this point in the history
  • Loading branch information
gernotstarke committed Oct 12, 2024
1 parent 8897468 commit 49f9e3c
Show file tree
Hide file tree
Showing 6 changed files with 15 additions and 24 deletions.
4 changes: 1 addition & 3 deletions docs/02-requirements/LG-02-02.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -82,8 +82,6 @@ They should recognize and account for the impact of:
** technology trends (e.g., Microservices)
** methodology trends (e.g., Agile)

Software architects are able to describe how those factors can influence
design decisions and can elaborate on the consequences of changing
influencing factors by providing examples for some of them (R2).
Software architects are able to describe how those factors can influence architecture decisions and can elaborate on the consequences of changing influencing factors by providing examples for some of them (R2).

// end::EN[]
4 changes: 2 additions & 2 deletions docs/03-design/01-design-duration-terms.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Darüber hinaus werden in diesem Abschnitt der Umgang mit Querschnittsthemen, di

Entwurf;
Vorgehen beim Entwurf;
Entwurfsentscheidung;
Architekturentscheidung;
Sichten;
{glossary_url}interface[Schnittstellen];
technische Konzepte und Querschnittsthemen;
Expand Down Expand Up @@ -51,7 +51,7 @@ They recognize the importance of design principles and solution patterns and are
In addition, this section addresses the management of cross-cutting concerns, the principles of software deployment and the challenges of distributed systems.

=== Relevant Terms
Design; design approach; design decision; views;
Design; design approach; architecture decision; views;
{glossary_url}interface[interfaces];
technical concepts and
{glossary_url}cross-cutting-concern[cross-cutting concerns];
Expand Down
6 changes: 3 additions & 3 deletions docs/03-design/LG-03-02.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@ Softwarearchitekt:innen können:

* Softwarearchitekturen auf Basis bekannter funktionaler und Qualitätsanforderungen für nicht sicherheits- oder unternehmenskritische Softwaresysteme entwerfen und angemessen kommunizieren und dokumentieren
* Strukturentscheidungen hinsichtlich Systemzerlegung und Bausteinstruktur treffen, dabei Abhängigkeiten zwischen Bausteinen festlegen (siehe <<LG-03-06>>)
* gegenseitige Abhängigkeiten und Abwägungen bezüglich Entwurfsentscheidungen erkennen und begründen
* gegenseitige Abhängigkeiten und Abwägungen bezüglich Architekturentscheidungen erkennen und begründen
* Begriffe {glossary_url}blockbox[Blackbox] und {glossary_url}whitebox[Whitebox] erklären und zielgerichtet anwenden
* schrittweise Verfeinerung und Spezifikation von Bausteinen durchführen
* Architektursichten entwerfen, insbesondere Baustein-, Laufzeit- und Verteilungssicht (siehe <<LG-04-05>>, <<kruchten95>>, <<rozanskiwoods>>, <<starkelorz>>, <<arc42>>, <<brownc4>>)
* die aus diesen Entscheidungen resultierenden Konsequenzen auf den Quellcode erklären
* domänenspezifische und technische Bestandteile in Architekturen trennen und diese Trennung begründen
* Risiken von Entwurfsentscheidungen identifizieren.
* Risiken von Architekturentscheidungen identifizieren.

// end::DE[]

Expand All @@ -25,7 +25,7 @@ Software architects are able to:

* design and appropriately communicate and document software architectures based upon known functional and quality requirements for software systems that are neither safety- nor business-critical
* make structure-relevant decisions regarding system decomposition and building-block structure and deliberately design dependencies between building blocks (see <<LG-03-06>>)
* recognize and justify interdependencies and trade-offs of design decisions
* recognize and justify interdependencies and trade-offs of {glossary_url}architecture decisions[architecture decisions]
* explain the terms {glossary_url}blockbox[black box] and {glossary_url}whitebox[white box] and apply them purposefully
* apply stepwise refinement and specify building blocks
* design architecture views, especially building-block view, runtime view and deployment view (see <<LG-04-05>>, <<kruchten95>>, <<rozanskiwoods>>, <<starkelorz>>, <<arc42>>, <<brownc4>>)
Expand Down
21 changes: 7 additions & 14 deletions docs/03-design/LG-03-05.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,12 @@
[[LG-03-05]]
==== LZ 03-05 [ehemaliges LZ 1-06]: Zusammenhang zwischen Feedback-Schleifen und Risiko (R1, R2)

Softwarearchitekt:innen verstehen die Notwendigkeit von Iterationen,
insbesondere bei unter Unsicherheit getroffenen Entscheidungen.
Softwarearchitekt:innen verstehen die Notwendigkeit von Iterationen, insbesondere bei unter Unsicherheit getroffenen Entscheidungen.
Sie

* können den Einfluss von iterativem Vorgehen auf
Architekturentscheidungen erläutern (hinsichtlich Risiken und
Prognostizierbarkeit). (R1)
* können inkrementell und iterativ arbeiten und entscheiden. (R2)
* verstehen die Notwendigkeit von Rückmeldungen zu
Entwurfsentscheidungen (R1)
* können den Einfluss von iterativem Vorgehen auf Architekturentscheidungen erläutern (hinsichtlich Risiken und Prognostizierbarkeit) (R1)
* können inkrementell und iterativ arbeiten und entscheiden (R2)
* verstehen die Notwendigkeit von Rückmeldungen zu Architekturentscheidungen (R1)
* können von anderen Stakeholdern systematisch Rückmeldung
einholen. (R2)

Expand All @@ -22,13 +18,10 @@ Sie
[[LG-03-05]]
==== LG 03-05 [previously LG 1-06]: Correlation between Feedback Loops and Risks (R1, R2)

Software architects understand the necessity of iterations, especially
when decision-making is affected by uncertainties. They
Software architects understand the necessity of iterations, especially when decision-making is affected by uncertainties. They

* are able to explain the influence of iterative approaches on
architectural decisions (with regard to risks and
predictability). (R1)
* are able to explain the influence of iterative approaches on architectural decisions (with regard to risks and predictability). (R1)
* can work and make decisions incrementally and iteratively. (R1)
* understand the necessity for feedback on design decisions. (R1)
* understand the necessity for feedback on architecture decisions. (R1)
* can systematically obtain feedback from other stakeholders. (R2)
// end::EN[]
2 changes: 1 addition & 1 deletion docs/04-documentation/01-documentation-duration-terms.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Außerdem lernen die Teilnehmer:innen, wichtige Architekturentscheidungen, Schni

=== Wesentliche Begriffe

(Architektur-)Sichten; Strukturen; (technische) Konzepte; Dokumentation; Kommunikation; Beschreibung; zielgruppen- oder stakeholdergerecht; Meta-Strukturen und Templates zur Beschreibung und Kommunikation; Kontextabgrenzung; Bausteine; Bausteinsicht; Laufzeitsicht; Verteilungssicht; Knoten; Kanal; Verteilungsartefakte; Mapping von Bausteinen auf Verteilungsartefakte; Beschreibung von Schnittstellen und Entwurfsentscheidungen; UML; Werkzeuge zur Dokumentation
(Architektur-)Sichten; Strukturen; (technische) Konzepte; Dokumentation; Kommunikation; Beschreibung; zielgruppen- oder stakeholdergerecht; Meta-Strukturen und Templates zur Beschreibung und Kommunikation; Kontextabgrenzung; Bausteine; Bausteinsicht; Laufzeitsicht; Verteilungssicht; Knoten; Kanal; Verteilungsartefakte; Mapping von Bausteinen auf Verteilungsartefakte; Beschreibung von Schnittstellen und Architekturentscheidungen; UML; Werkzeuge zur Dokumentation

// end::DE[]

Expand Down
2 changes: 1 addition & 1 deletion docs/04-documentation/LG-04-08.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Softwarearchitekt:innen kennen Architecture-Decision-Records (ADR, siehe <<nygar
Software architects are able to:

* systematically make, justify, communicate, and document architectural decisions
* identify, communicate, and document interdependencies between design decisions
* identify, communicate, and document interdependencies between architecture decisions

Software architects know about Architecture-Decision-Records (ADR, see <<nygard>>) and can apply these to document decisions (R2).

Expand Down

0 comments on commit 49f9e3c

Please sign in to comment.