From 49f9e3ca243507fabd4bcf3e33c9fbf45c69cecd Mon Sep 17 00:00:00 2001 From: "Dr. Gernot Starke" Date: Sat, 12 Oct 2024 16:51:34 +0200 Subject: [PATCH] #606-replaced Design-Decisions by Architecture Decisions --- docs/02-requirements/LG-02-02.adoc | 4 +--- docs/03-design/01-design-duration-terms.adoc | 4 ++-- docs/03-design/LG-03-02.adoc | 6 +++--- docs/03-design/LG-03-05.adoc | 21 +++++++------------ .../01-documentation-duration-terms.adoc | 2 +- docs/04-documentation/LG-04-08.adoc | 2 +- 6 files changed, 15 insertions(+), 24 deletions(-) diff --git a/docs/02-requirements/LG-02-02.adoc b/docs/02-requirements/LG-02-02.adoc index b6891af..3618a5b 100644 --- a/docs/02-requirements/LG-02-02.adoc +++ b/docs/02-requirements/LG-02-02.adoc @@ -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[] diff --git a/docs/03-design/01-design-duration-terms.adoc b/docs/03-design/01-design-duration-terms.adoc index 2a750cf..fb5a1c4 100644 --- a/docs/03-design/01-design-duration-terms.adoc +++ b/docs/03-design/01-design-duration-terms.adoc @@ -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; @@ -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]; diff --git a/docs/03-design/LG-03-02.adoc b/docs/03-design/LG-03-02.adoc index cd73a11..24767ec 100644 --- a/docs/03-design/LG-03-02.adoc +++ b/docs/03-design/LG-03-02.adoc @@ -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 <>) -* 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 <>, <>, <>, <>, <>, <>) * 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[] @@ -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 <>) -* 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 <>, <>, <>, <>, <>, <>) diff --git a/docs/03-design/LG-03-05.adoc b/docs/03-design/LG-03-05.adoc index 74ff254..e19f267 100644 --- a/docs/03-design/LG-03-05.adoc +++ b/docs/03-design/LG-03-05.adoc @@ -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) @@ -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[] diff --git a/docs/04-documentation/01-documentation-duration-terms.adoc b/docs/04-documentation/01-documentation-duration-terms.adoc index 5293fdf..0b8f9f8 100644 --- a/docs/04-documentation/01-documentation-duration-terms.adoc +++ b/docs/04-documentation/01-documentation-duration-terms.adoc @@ -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[] diff --git a/docs/04-documentation/LG-04-08.adoc b/docs/04-documentation/LG-04-08.adoc index 4520e5d..f6a190a 100644 --- a/docs/04-documentation/LG-04-08.adoc +++ b/docs/04-documentation/LG-04-08.adoc @@ -18,7 +18,7 @@ Softwarearchitekt:innen kennen Architecture-Decision-Records (ADR, siehe <>) and can apply these to document decisions (R2).