Merge pull request #557 from isaqb-org/#535-create-section-for-refere…

…nces Create Section for References
isaqb-org · Oct 8, 2024 · b23f098 · b23f098
2 parents 5e0427c + fafd808
commit b23f098
Show file tree

Hide file tree

Showing 4 changed files with 31 additions and 36 deletions.
diff --git a/docs/01-basics/01-basics-duration-terms.adoc b/docs/01-basics/01-basics-duration-terms.adoc
@@ -15,20 +15,20 @@ Außerdem wird deren Rolle im organisatorischen Kontext und ihre Interaktion mit
 
 === Wesentliche Begriffe
 {glossary_url}software-architecture[Softwarearchitektur];
-Architekturdomänen; 
-{glossary_url}structure[Struktur]; 
-{glossary_url}building-block[Bausteine]; 
-{glossary_url}component[Komponenten]; 
-{glossary_url}interface[Schnittstellen]; 
-{glossary_url}relationship[Beziehungen]; 
+Architekturdomänen;
+{glossary_url}structure[Struktur];
+{glossary_url}building-block[Bausteine];
+{glossary_url}component[Komponenten];
+{glossary_url}interface[Schnittstellen];
+{glossary_url}relationship[Beziehungen];
 {glossary_url}cross-cutting-concern[Querschnittsthemen];
-Nutzen von Softwarearchitektur; 
-Softwarearchitekt:innen und deren Verantwortlichkeiten; 
-Rolle; 
-Aufgaben und benötigte Fähigkeiten; 
-Stakeholder und deren Anliegen; 
-Anforderungen; 
-{glossary_url}constraints[Randbedingungen]; 
+Nutzen von Softwarearchitektur;
+Softwarearchitekt:innen und deren Verantwortlichkeiten;
+Rolle;
+Aufgaben und benötigte Fähigkeiten;
+Stakeholder und deren Anliegen;
+Anforderungen;
+{glossary_url}constraint[Randbedingungen];
 Einflussfaktoren
 
 // end::DE[]
@@ -48,18 +48,18 @@ Furthermore, they will be able to name and explain the most important tasks and
 Additionally, the section explores the role of software architects in the broader architectural context and their interactions with other stakeholders, preparing participants to effectively contribute to diverse software development projects.
 
 === Relevant Terms
-{glossary_url}software-architecture[Software architecture]; 
-architecture domains; {glossary_url}structure[structure]; 
-{glossary_url}building-block[building blocks]; 
-{glossary_url}component[components]; 
-{glossary_url}interface[interfaces]; 
-{glossary_url}relationship[relationships]; 
+{glossary_url}software-architecture[Software architecture];
+architecture domains; {glossary_url}structure[structure];
+{glossary_url}building-block[building blocks];
+{glossary_url}component[components];
+{glossary_url}interface[interfaces];
+{glossary_url}relationship[relationships];
 {glossary_url}cross-cutting-concern[cross-cutting concerns];
-software architects and their responsibilities; 
-tasks and required skills; 
-stakeholders and their concerns; 
+software architects and their responsibilities;
+tasks and required skills;
+stakeholders and their concerns;
 requirements;
-{glossary_url}constraints[constraints]; 
+{glossary_url}constraint[constraints];
 influencing factors
 
 // end::EN[]

diff --git a/docs/01-basics/LZ-01-01.adoc b/docs/01-basics/LZ-01-01.adoc
@@ -1,9 +1,8 @@
-
 // tag::DE[]
 [[LG-01-01]]
 ==== LZ 01-01: Definitionen von Softwarearchitektur diskutieren (R1)
-Softwarearchitekt:innen kennen die Gemeinsamkeiten vieler Definitionen
-von Softwarearchitektur <<iso42010>> <<bass>> <<kruchten>>:
+
+Softwarearchitekt:innen kennen die Gemeinsamkeiten vieler Definitionen von Softwarearchitektur:
 
 * {glossary_url}building-block[Komponenten/Bausteine] mit Schnittstellen und Beziehungen
 * Bausteine als allgemeiner Begriff, Komponenten als eine spezielle Ausprägung davon
@@ -17,12 +16,14 @@ von Softwarearchitektur <<iso42010>> <<bass>> <<kruchten>>:
 [[LG-01-01]]
 ==== LG 01-01: Discuss Definitions of Software Architecture (R1)
 
-Software architects know the commonalities of many definitions of
-software architecture <<iso42010>> <<bass>> <<kruchten>>:
+Software architects know the commonalities of many definitions of software architecture:
 
 * {glossary_url}building-block[components/building blocks] with interfaces and relationships
 * building blocks as a general term, components as a special form thereof
 * structures, {glossary_url}cross-cutting-concern[cross-cutting concerns], principles
 * architecture decisions and their consequences on the entire systems and its lifecycle
 
 // end::EN[]
+
+===== {references}
+<<iso42010>>, <<bass>>, <<kruchten>>
diff --git a/docs/02-requirements/LZ-02-04.adoc b/docs/02-requirements/LZ-02-04.adoc
@@ -7,7 +7,7 @@ Softwarearchitekt:innen:
 
 * können Szenarien für gegebene Qualitäten mit Kontext, Stimulus und Reaktion oder Messmethode formulieren <<bass>> (R1)
 * verstehen, dass eine Anforderung für eine gegebene Qualität
-  eine Analysemethode spezifizieren sollte (siehe <<LZ-05-02>>) (R1)
+  eine Analysemethode spezifizieren sollte (siehe <<LG-05-02>>) (R1)
 * wissen, dass die Verwendung einer Metrik als Ziel diese invalidieren kann (R2), wie z.{nbsp}B. in Goodhart's Law (R3) beschrieben
 
 // end::DE[]

diff --git a/docs/config/setup.adoc b/docs/config/setup.adoc
@@ -31,13 +31,7 @@ endif::[]
 
 // ":include_configuration:" always consists of the language,
 // additional markers might be configured here!
-:include_configuration: tags={language}
-
-
-// ":bibrefs:" (bibliography entries) are single language, to avoid redundancy.
-// therefore the appropriate include statements don't contain a language,
-// but the "BIB_REFS" tag.
-:bibrefs: BIB_REFS
+:include_configuration: tags=!*;{language}
 
 // glossary definitions
 // iSAQB maintains and publishes a "Glossary of Software Architecture Terminology"