From 08ef9d3daf33b68013dc87eeaa6a6d2891c374c6 Mon Sep 17 00:00:00 2001 From: Markus Harrer Date: Thu, 11 Jul 2024 15:40:57 +0200 Subject: [PATCH 1/5] add current reference material --- docs/99-references/00-references.adoc | 38 +++++++++++++++++++++------ 1 file changed, 30 insertions(+), 8 deletions(-) diff --git a/docs/99-references/00-references.adoc b/docs/99-references/00-references.adoc index 6d3afa4..438f3db 100644 --- a/docs/99-references/00-references.adoc +++ b/docs/99-references/00-references.adoc @@ -10,7 +10,7 @@ Dieser Abschnitt enthält Quellenangaben, die ganz oder teilweise im Curriculum // end::DE[] // tag::EN[] -This section contains references that are cited in the curriculum. +This section contains references to material where many ideas of the curriculum are based on. // end::EN[] @@ -21,34 +21,56 @@ This section contains references that are cited in the curriculum. **B** -- [[[bass,Bass+ 2012]]] Len Bass, Paul Clements, Rick Kazman: Software Architecture in Practice. 3rd Edition, Addison-Wesley, 2012. +- [[[bass,Bass+ 2021]]] Len Bass, Paul Clements, Rick Kazman: Software Architecture in Practice. 4rd Edition, Addison-Wesley, 2021. +- [[[bellotti,Bellotti 2021]]] Marianne Bellotti: Kill It with Fire: Manage Aging Computer Systems (and Future Proof Modern Ones), No Starch Press, 2021. -**C** -- [[[clements,Clements+ 2001]]] Paul Clements, Rick Kazman, Mark Klein: Evaluating Software Architectures Methods and Case Studies. Addison-Wesley, 2001. +**D** + +- [[[demeyer,Demeyer+ 2023]]] Serge Demeyer, Stéphane Ducasse and Oscar Nierstrasz: Object-Oriented Reengineering Patterns, 2003. **F** -- [[[feathers,Feathers+ 2007]]] Michael Feathers: Working Effectively with Legacy Code. Prentice Hall, 2007. +- [[[feathers,Feathers+ 2004]]] Michael Feathers: Working Effectively with Legacy Code. Pearson, 2004. + +- [[[ford, Ford+ 2021]]] Neal Ford, Mark Richards, Pramod Sadalage, Zhamak Dehghani: Software Architecture: The Hard Parts: Modern Trade-Off Analyses for Distributed Architectures, O'Reilly, 2021. + +- [[[fowler,Fowler+ 2019]]] Martin Fowler with Kent Beck: Refactoring: Improving the Design of Existing Code. Addison-Wesley, 2019. + -- [[[fowler,Fowler+ 1999]]] Martin Fowler, Kent Beck: Refactoring: Improving the Design of Existing Code. Addison-Wesley, 1999. +**K** + +- [[[knodel,knodel+ 2016]]] Jens Knodel, Matthias Naab: Pragmatic Evaluation of Software Architectures. Springer, 2016. + +- [[[koppelt,Koppelt+ 2021]]] Christine Koppelt, Markus Harrer, Gernot Starke, Benjamin Wolf, and Martin Otten: Software Reviews - Identifying Risks and Problems in Software. Leanpub, 2021. **L** -- [[[lippert,Lippert+ 2007]]] Martin Lippert, Stefan Roock: Refactoring in Large Software Projects: Performing Complex Restructurings Successfully. Wiley, 2007. +- [[[lemaire,Lemaire 2020]]] Maude Lemaire: Refactoring At Scale: Regaining Control of Your Codebase. O'Reilly, 2020. - [[[lilienthal,Lilienthal 2019]]] Carola Lilienthal: Sustainable Software Architecture: Analyze and Reduce Technical Debt. dpunkt.verlag, 2019. +- [[[lippert,Lippert+ 2007]]] Martin Lippert, Stefan Roock: Refactoring in Large Software Projects: Performing Complex Restructurings Successfully. Wiley, 2007. + **M** - [[[mcconnell,McConnell 2006]]] Steve McConnell: Software Estimation: Demystifying the Black Art. Microsoft Press, 2006. -- [[[murer,Murer+ 2019]]] Stephan Murer, Bruno Bonati: Managed Evolution: A Strategy for Very Large Information Systems. Springer, 2010. **N** - [[[newman,Newman 2019]]] Sam Newman: Monolith to Microservices: Evolutionary Patterns to Transform Your Monolith. O'Reilly, 2019. + + +**P** + +- [[[pacheco,Pacheco+ 2023]]] Diego Pacheco, Sam Sgro: Principles of Software Architecture Modernization: Delivering engineering excellence with the art of fixing microservices, monoliths, and distributed monoliths. BPB Publications, 2023. + + +**T** + +- [[[tune,Tune+ 2024]]] Nick Tune with Jean-Georges Perrin: Architecture Modernization: Socio-technical alignment of software, strategy, and structure. Manning, 2024. \ No newline at end of file From 7eb4104f02c7cedd43aa9b6b66851ffe77e56505 Mon Sep 17 00:00:00 2001 From: Markus Harrer Date: Thu, 11 Jul 2024 15:42:44 +0200 Subject: [PATCH 2/5] fix lowercase --- docs/99-references/00-references.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/99-references/00-references.adoc b/docs/99-references/00-references.adoc index 438f3db..2d864c5 100644 --- a/docs/99-references/00-references.adoc +++ b/docs/99-references/00-references.adoc @@ -42,7 +42,7 @@ This section contains references to material where many ideas of the curriculum **K** -- [[[knodel,knodel+ 2016]]] Jens Knodel, Matthias Naab: Pragmatic Evaluation of Software Architectures. Springer, 2016. +- [[[knodel,Knodel+ 2016]]] Jens Knodel, Matthias Naab: Pragmatic Evaluation of Software Architectures. Springer, 2016. - [[[koppelt,Koppelt+ 2021]]] Christine Koppelt, Markus Harrer, Gernot Starke, Benjamin Wolf, and Martin Otten: Software Reviews - Identifying Risks and Problems in Software. Leanpub, 2021. From 7e554d660acd44b30ba374c2ab8493c6ed60cece Mon Sep 17 00:00:00 2001 From: Markus Harrer Date: Thu, 11 Jul 2024 16:07:07 +0200 Subject: [PATCH 3/5] fixed typos --- docs/99-references/00-references.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/99-references/00-references.adoc b/docs/99-references/00-references.adoc index 2d864c5..8091de4 100644 --- a/docs/99-references/00-references.adoc +++ b/docs/99-references/00-references.adoc @@ -21,14 +21,14 @@ This section contains references to material where many ideas of the curriculum **B** -- [[[bass,Bass+ 2021]]] Len Bass, Paul Clements, Rick Kazman: Software Architecture in Practice. 4rd Edition, Addison-Wesley, 2021. +- [[[bass,Bass+ 2021]]] Len Bass, Paul Clements, Rick Kazman: Software Architecture in Practice. 4th Edition, Addison-Wesley, 2021. - [[[bellotti,Bellotti 2021]]] Marianne Bellotti: Kill It with Fire: Manage Aging Computer Systems (and Future Proof Modern Ones), No Starch Press, 2021. **D** -- [[[demeyer,Demeyer+ 2023]]] Serge Demeyer, Stéphane Ducasse and Oscar Nierstrasz: Object-Oriented Reengineering Patterns, 2003. +- [[[demeyer,Demeyer+ 2003]]] Serge Demeyer, Stéphane Ducasse and Oscar Nierstrasz: Object-Oriented Reengineering Patterns, 2003. **F** From bd634fa11615cecd7e12c86ef5197a6aaa6d0ea3 Mon Sep 17 00:00:00 2001 From: Markus Harrer Date: Fri, 12 Jul 2024 11:57:16 +0200 Subject: [PATCH 4/5] add section for references in German --- docs/99-references/00-references.adoc | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/99-references/00-references.adoc b/docs/99-references/00-references.adoc index 8091de4..2d2d2d8 100644 --- a/docs/99-references/00-references.adoc +++ b/docs/99-references/00-references.adoc @@ -6,13 +6,21 @@ == {references} // tag::DE[] -Dieser Abschnitt enthält Quellenangaben, die ganz oder teilweise im Curriculum referenziert werden. +Dieser Abschnitt enthält Verweise auf deutschsprachige Referenzen, auf denen viele Ideen des Lehrplans beruhen. + +**L** + +- [[[lilienthalddt,Lilienthal+ 2023]]] Carola Lilienthal, Henning Schwentner: Domain-Driven Transformation: Monolithen und Microservices zukunftsfähig machen. dpunkt.verlag. 2023. + +Nachfolgend sind weitere genutzte, englischsprachige Referenzen aufgeführt. // end::DE[] +// This sentence is just relevant for the English version of the curriculum. // tag::EN[] -This section contains references to material where many ideas of the curriculum are based on. +This section contains the references where many ideas of the curriculum are based on. // end::EN[] +// This section should be part of the German and the English curriculum. That's why this section isn't wrapped with EN[] tags. **A** @@ -73,4 +81,6 @@ This section contains references to material where many ideas of the curriculum **T** -- [[[tune,Tune+ 2024]]] Nick Tune with Jean-Georges Perrin: Architecture Modernization: Socio-technical alignment of software, strategy, and structure. Manning, 2024. \ No newline at end of file +- [[[tune,Tune+ 2024]]] Nick Tune with Jean-Georges Perrin: Architecture Modernization: Socio-technical alignment of software, strategy, and structure. Manning, 2024. + + From 4f82c92113d0f18d3ecbb356f693c131e303a9cf Mon Sep 17 00:00:00 2001 From: Markus Harrer Date: Fri, 12 Jul 2024 11:57:32 +0200 Subject: [PATCH 5/5] fix parser warnings because of false positives --- docs/00b-basics/00-basics.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/00b-basics/00-basics.adoc b/docs/00b-basics/00-basics.adoc index 79711f3..46ee3cd 100644 --- a/docs/00b-basics/00-basics.adoc +++ b/docs/00b-basics/00-basics.adoc @@ -15,3 +15,9 @@ include::04-prerequisites-for-this-training.adoc[{include_configuration}] include::05-curriculum-outline.adoc[{include_configuration}] include::06-complementary-information.adoc[{include_configuration}] + +// tags for multilanguage support are listed here to get rid of false positives from the asciidoctor parser +// tag::DE[] +// end::DE[] +// tag::EN[] +// end::EN[] \ No newline at end of file