Skip to content
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

Create Section for References #557

Merged
merged 7 commits into from
Oct 8, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 23 additions & 23 deletions docs/01-basics/01-basics-duration-terms.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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[]
Expand All @@ -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[]
Expand Down
11 changes: 6 additions & 5 deletions docs/01-basics/LZ-01-01.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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>>
2 changes: 1 addition & 1 deletion docs/02-requirements/LZ-02-04.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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[]
Expand Down
8 changes: 1 addition & 7 deletions docs/config/setup.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down