From 96abc65c13f86345d0b76a3ec27ed9b3f48d73bd Mon Sep 17 00:00:00 2001 From: "Uwe M. Schirmer" Date: Thu, 11 Jan 2024 00:37:46 +0100 Subject: [PATCH 1/9] Initial version of theme backlog --- README.adoc | 60 ++++++++------- docs-ext/EXTERNAL_DOCUMENTS_README.adoc | 7 +- docs/00a-preamble/00-introduction.adoc | 13 ---- ...to-expect-of-an-advanced-level-module.adoc | 15 ---- .../02-advanced-level-knowledge.adoc | 21 ----- docs/00a-preamble/03-prerequisites.adoc | 25 ------ docs/00b-basics/00-basics.adoc | 17 ----- .../01-what-to-expect-of-this-module.adoc | 20 ----- ...structure-and-chronological-breakdown.adoc | 47 ------------ .../03-timing-didactics-and-more.adoc | 49 ------------ .../04-prerequisites-for-this-training.adoc | 40 ---------- docs/00b-basics/05-curriculum-outline.adoc | 24 ------ .../06-complementary-information.adoc | 12 --- docs/01-module-block-1/00-structure.adoc | 20 ----- docs/01-module-block-1/01-duration-terms.adoc | 29 ------- docs/01-module-block-1/02-learning-goals.adoc | 26 ------- docs/01-module-block-1/references.adoc | 14 ---- docs/01-themenspeicher/00-structure.adoc | 42 ++++++++++ .../01-auswirkungen-ddd-unternehmen.adoc | 34 +++++++++ .../02-dokumentation-sw-architekuren.adoc | 75 ++++++++++++++++++ .../03-einsatz-nosql-datenbanken-projekt.adoc | 34 +++++++++ .../04-erfahrungen-cloud.adoc | 12 +++ ...rfahrungen-event-driven-architekturen.adoc | 76 +++++++++++++++++++ ...nd-entwicklung-gro\303\237e-Projekte.adoc" | 72 ++++++++++++++++++ .../07-maschinelles-lernen-in-der-praxis.adoc | 30 ++++++++ .../08-migration-microservices-k8s.adoc | 33 ++++++++ .../09.modellierungssprachen.adoc | 46 +++++++++++ .../10-solid-versus-cupid.adoc | 29 +++++++ docs/02-module-block-2/00-structure.adoc | 18 ----- docs/02-module-block-2/01-duration-terms.adoc | 30 -------- docs/02-module-block-2/02-learning-goals.adoc | 34 --------- docs/02-module-block-2/references.adoc | 12 --- docs/03-module-block-3/00-structure.adoc | 18 ----- docs/03-module-block-3/01-duration-terms.adoc | 30 -------- docs/03-module-block-3/02-learning-goals.adoc | 34 --------- docs/03-module-block-3/references.adoc | 13 ---- docs/04-module-block-4/00-structure.adoc | 18 ----- docs/04-module-block-4/01-duration-terms.adoc | 29 ------- docs/04-module-block-4/02-learning-goals.adoc | 34 --------- docs/04-module-block-4/references.adoc | 14 ---- docs/05-module-block-5/00-structure.adoc | 18 ----- docs/05-module-block-5/01-duration-terms.adoc | 29 ------- docs/05-module-block-5/02-learning-goals.adoc | 34 --------- docs/05-module-block-5/references.adoc | 12 --- docs/20-examples/00-examples.adoc | 7 -- .../01-examples-duration-terms.adoc | 32 -------- docs/20-examples/02-learning-goals.adoc | 28 ------- docs/20-examples/references.adoc | 13 ---- docs/99-references/00-references.adoc | 53 ------------- docs/config/setup.adoc | 8 +- docs/index.adoc | 15 +--- docs/index_rc.adoc | 8 +- docs/topic-backlog-expert-level.adoc | 33 +------- 53 files changed, 530 insertions(+), 966 deletions(-) delete mode 100644 docs/00a-preamble/00-introduction.adoc delete mode 100644 docs/00a-preamble/01-what-to-expect-of-an-advanced-level-module.adoc delete mode 100644 docs/00a-preamble/02-advanced-level-knowledge.adoc delete mode 100644 docs/00a-preamble/03-prerequisites.adoc delete mode 100644 docs/00b-basics/00-basics.adoc delete mode 100644 docs/00b-basics/01-what-to-expect-of-this-module.adoc delete mode 100644 docs/00b-basics/02-curriculum-structure-and-chronological-breakdown.adoc delete mode 100644 docs/00b-basics/03-timing-didactics-and-more.adoc delete mode 100644 docs/00b-basics/04-prerequisites-for-this-training.adoc delete mode 100644 docs/00b-basics/05-curriculum-outline.adoc delete mode 100644 docs/00b-basics/06-complementary-information.adoc delete mode 100644 docs/01-module-block-1/00-structure.adoc delete mode 100644 docs/01-module-block-1/01-duration-terms.adoc delete mode 100644 docs/01-module-block-1/02-learning-goals.adoc delete mode 100644 docs/01-module-block-1/references.adoc create mode 100644 docs/01-themenspeicher/00-structure.adoc create mode 100644 docs/01-themenspeicher/01-auswirkungen-ddd-unternehmen.adoc create mode 100644 docs/01-themenspeicher/02-dokumentation-sw-architekuren.adoc create mode 100644 docs/01-themenspeicher/03-einsatz-nosql-datenbanken-projekt.adoc create mode 100644 docs/01-themenspeicher/04-erfahrungen-cloud.adoc create mode 100644 docs/01-themenspeicher/05-erfahrungen-event-driven-architekturen.adoc create mode 100644 "docs/01-themenspeicher/06-frontend-entwicklung-gro\303\237e-Projekte.adoc" create mode 100644 docs/01-themenspeicher/07-maschinelles-lernen-in-der-praxis.adoc create mode 100644 docs/01-themenspeicher/08-migration-microservices-k8s.adoc create mode 100644 docs/01-themenspeicher/09.modellierungssprachen.adoc create mode 100644 docs/01-themenspeicher/10-solid-versus-cupid.adoc delete mode 100644 docs/02-module-block-2/00-structure.adoc delete mode 100644 docs/02-module-block-2/01-duration-terms.adoc delete mode 100644 docs/02-module-block-2/02-learning-goals.adoc delete mode 100644 docs/02-module-block-2/references.adoc delete mode 100644 docs/03-module-block-3/00-structure.adoc delete mode 100644 docs/03-module-block-3/01-duration-terms.adoc delete mode 100644 docs/03-module-block-3/02-learning-goals.adoc delete mode 100644 docs/03-module-block-3/references.adoc delete mode 100644 docs/04-module-block-4/00-structure.adoc delete mode 100644 docs/04-module-block-4/01-duration-terms.adoc delete mode 100644 docs/04-module-block-4/02-learning-goals.adoc delete mode 100644 docs/04-module-block-4/references.adoc delete mode 100644 docs/05-module-block-5/00-structure.adoc delete mode 100644 docs/05-module-block-5/01-duration-terms.adoc delete mode 100644 docs/05-module-block-5/02-learning-goals.adoc delete mode 100644 docs/05-module-block-5/references.adoc delete mode 100644 docs/20-examples/00-examples.adoc delete mode 100644 docs/20-examples/01-examples-duration-terms.adoc delete mode 100644 docs/20-examples/02-learning-goals.adoc delete mode 100644 docs/20-examples/references.adoc delete mode 100644 docs/99-references/00-references.adoc diff --git a/README.adoc b/README.adoc index 6635e19..aa652e5 100644 --- a/README.adoc +++ b/README.adoc @@ -1,7 +1,4 @@ -= https://isaqb.org[iSAQB] Topic Backlog for CPSA®-Expert Level - -:toc: -:toc-placement!: += Topic Backlog for the https://isaqb.org[iSAQB]^®^ CPSA^®^ Expert Level ifdef::env-github[] :tip-caption: :bulb: @@ -12,49 +9,56 @@ ifdef::env-github[] endif::[] == Status -image:https://github.com/isaqb-org/topic-backlog-expert-level/workflows/CI%20-%20Releases%20and%20Main/badge.svg?branch=main["CI – Releases and Main"] -image:https://img.shields.io/github/last-commit/isaqb-org/topic-backlog-expert-level/main.svg["Last commit"] -image:https://img.shields.io/github/contributors/isaqb-org/topic-backlog-expert-level.svg["Contributors",link="https://github.com/isaqb-org/topic-backlog-expert-level/graphs/contributors"] -image:https://img.shields.io/github/issues/isaqb-org/topic-backlog-expert-level.svg["Issues",link="https://github.com/isaqb-org/topic-backlog-expert-level/issues"] -image:https://img.shields.io/github/issues-closed/isaqb-org/topic-backlog-expert-level.svg["Issues closed",link="https://github.com/isaqb-org/topic-backlog-expert-level/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aclosed+"] - +image:https://github.com/isaqb-org/examination-expert/workflows/CI%20-%20Releases%20and%20Main/badge.svg?branch=main["CI – Releases and Main"] +image:https://img.shields.io/github/last-commit/isaqb-org/examination-expert/main.svg["Last commit"] +image:https://img.shields.io/github/contributors/isaqb-org/examination-expert.svg["Contributors",link="https://github.com/isaqb-org/examination-expert/graphs/contributors"] +image:https://img.shields.io/github/issues/isaqb-org/examination-expert.svg["Issues",link="https://github.com/isaqb-org/examination-expert/issues"] +image:https://img.shields.io/github/issues-closed/isaqb-org/examination-expert.svg["Issues closed",link="https://github.com/isaqb-org/examination-expert/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aclosed+"] This is <>. == Content -This repository contains a list of topics that can be chosen for the iSAQB® CPSA®-Expert Level examination. +This repository contains the topic backlog for the iSAQB^®^ CPSA^®^ Expert Level in AsciiDoc. -toc::[] +== How to clone the project +The project uses Git Modules. So, don't forget to clone the repository with the option --recursive. + +If you forgot the option --recursive, you can load the Git Modules with this command +[source,console] +$ git submodule update --init == How to contribute or participate Create an issue, a merge- or pull-request -== How to build this project -Clone the repository—including the submodules: +== How to build the documents +Prerequisite: You need a Java Runtime(tm) installed. --- -[source,shell] ----- -Via SSH: -git clone git@github.com:isaqb-org/topic-backlog-expert-level.git --recursive +You build the output documents with gradle: +[source,console] +$ ./gradlew buildDocs -Via HTTPS: -git clone https://github.com/isaqb-org/topic-backlog-expert-level.git --recursive +That will produce both pdf and html output in German (DE) _and_ English (EN), unless you modify the configuration. + +In case you want to change that, adjust the following part of `build.gradle`: + +[source,groovy] +---- +task buildDocs { + group 'Documentation' + description 'Grouping task for generating all languages in several formats' + dependsOn "renderDE", "renderEN" +} ---- --- -. Build the project with http://www.gradle.com[gradle] (you need a locally installed JDK 17 or higher) via `./gradlew buildDocs`. -. Once the "BUILD SUCCESSFUL" is show, you can review the build result under `./build/index.html` +In the task "renderDE", certain attributes (aka variables) are defined that configure the corresponding output. == Additional translations/languages include::docs-ext/EXTERNAL_DOCUMENTS_README.adoc[] == Maintainers -This repository is currently maintained by the Expert Level Maintainer group of iSAQB> -It was forked from https://github.com/isaqb-org/advanced-template, -so the contributors of that project basically contributed to this one, too. - +This repository is currently maintained by the Examination Level Working Group +It was forked from https://github.com/isaqb-org/topic-backlog-expert-level. [[copyrighted]] == Licensing and Copyright diff --git a/docs-ext/EXTERNAL_DOCUMENTS_README.adoc b/docs-ext/EXTERNAL_DOCUMENTS_README.adoc index 0d32bfc..9304a54 100644 --- a/docs-ext/EXTERNAL_DOCUMENTS_README.adoc +++ b/docs-ext/EXTERNAL_DOCUMENTS_README.adoc @@ -1,13 +1,12 @@ -Copy translated versions (PDF) of the curriculum (other than German or English) to the directory `docs-ext`. +Copy translated versions (PDF) of the topic backlog (other than German or English) to the directory `docs-ext`. Please make sure, that the file name is well-formed and complies with the following format: -`curriculum-xxxx-lc.pdf` +`topic-backlog-expert-level-lc.pdf` -`xxxx`: insert the name of the curriculum, e.g. `web` or `flex` + `lc`: iso language code of the translation, e.g. `es` (Spanish) or `pt` (Portuguese) -Example: `curriculum-web-es.pdf` <- Spanish version of the WEB curriculum. +Example: `topic-backlog-expert-level-es.pdf` <- Spanish version of the WEB curriculum. **ATTENTION:** For every document that you add to `docs-ext`, you also have to create an entry in `index.adoc` so that people can access it from the overview page of this curriculum. diff --git a/docs/00a-preamble/00-introduction.adoc b/docs/00a-preamble/00-introduction.adoc deleted file mode 100644 index d5a7d72..0000000 --- a/docs/00a-preamble/00-introduction.adoc +++ /dev/null @@ -1,13 +0,0 @@ -// tag::DE[] -== Einführung: Allgemeines zum iSAQB Advanced Level -// end::DE[] - -// tag::EN[] -== Introduction: General information about the iSAQB Advanced Level -// end::EN[] - -include::01-what-to-expect-of-an-advanced-level-module.adoc[{include_configuration}] - -include::02-advanced-level-knowledge.adoc[{include_configuration}] - -include::03-prerequisites.adoc[{include_configuration}] diff --git a/docs/00a-preamble/01-what-to-expect-of-an-advanced-level-module.adoc b/docs/00a-preamble/01-what-to-expect-of-an-advanced-level-module.adoc deleted file mode 100644 index f2c2328..0000000 --- a/docs/00a-preamble/01-what-to-expect-of-an-advanced-level-module.adoc +++ /dev/null @@ -1,15 +0,0 @@ -// tag::DE[] -=== Was vermittelt ein Advanced Level Modul? - -Das Modul kann unabhängig von einer CPSA-F-Zertifizierung besucht werden. - -- Der iSAQB Advanced Level bietet eine modulare Ausbildung in drei Kompetenzbereichen mit flexibel gestaltbaren Ausbildungswegen. Er berücksichtigt individuelle Neigungen und Schwerpunkte. -- Die Zertifizierung erfolgt als Hausarbeit. Die Bewertung und mündliche Prüfung wird durch vom iSAQB benannte Expert:innen vorgenommen. -// end::DE[] - -// tag::EN[] -=== What is taught in an Advanced Level module? -- The iSAQB Advanced Level offers modular training in three areas of competence with flexibly designable training paths. It takes individual inclinations and priorities into account. -- The certification is done as an assignment. The assessment and oral exam is conducted by experts appointed by the iSAQB. -// end::EN[] - diff --git a/docs/00a-preamble/02-advanced-level-knowledge.adoc b/docs/00a-preamble/02-advanced-level-knowledge.adoc deleted file mode 100644 index 9d5683e..0000000 --- a/docs/00a-preamble/02-advanced-level-knowledge.adoc +++ /dev/null @@ -1,21 +0,0 @@ -// tag::DE[] -=== Was können Absolventen des Advanced Level (CPSA-A)? -CPSA-A-Absolventen können: - -- eigenständig und methodisch fundiert mittlere bis große IT-Systeme entwerfen -- in IT-Systemen mittlerer bis hoher Kritikalität technische und inhaltliche Verantwortung übernehmen -- Maßnahmen zur Erreichung von Qualitätsanforderungen konzeptionieren, entwerfen und dokumentieren sowie Entwicklungsteams bei der Umsetzung dieser Maßnahmen begleiten -- architekturrelevante Kommunikation in mittleren bis großen Entwicklungsteams steuern und durchführen - -// end::DE[] - -// tag::EN[] -=== What can Advanced Level (CPSA-A) graduates do? -CPSA-A graduates can: - -- Independently and methodically design medium to large IT systems -- In IT systems of medium to high criticality, assume technical and content-related responsibility -- Conceptualize, design, and document actions to achieve quality requirements and support development teams in the implementation of these actions -- Control and execute architecture-relevant communication in medium to large development teams -// end::EN[] - diff --git a/docs/00a-preamble/03-prerequisites.adoc b/docs/00a-preamble/03-prerequisites.adoc deleted file mode 100644 index adc00b6..0000000 --- a/docs/00a-preamble/03-prerequisites.adoc +++ /dev/null @@ -1,25 +0,0 @@ -// tag::DE[] -=== Voraussetzungen zur CPSA-A-Zertifizierung -* erfolgreiche Ausbildung und Zertifizierung zum Certified Professional for Software Architecture, Foundation Level^(R)^ (CPSA-F) -* mindestens drei Jahre Vollzeit-Berufserfahrung in der IT-Branche; dabei Mitarbeit an Entwurf und Entwicklung von mindestens zwei unterschiedlichen IT-Systemen -** Ausnahmen sind auf Antrag zulässig (etwa: Mitarbeit in Open-Source-Projekten) -* Aus- und Weiterbildung im Rahmen von iSAQB-Advanced-Level-Schulungen im Umfang von mindestens 70 Credit Points aus mindestens drei unterschiedlichen Kompetenzbereichen -* erfolgreiche Bearbeitung der CPSA-A-Zertifizierungsprüfung - -// end::DE[] - -// tag::EN[] -=== Requirements for CPSA-A certification -* Successful training and certification as a Certified Professional for Software Architecture, Foundation Level^(R)^ (CPSA-F) -* At least three years of full-time professional experience in the IT sector; collaboration on the design and development of at least two different IT systems -** Exceptions are allowed on application (e.g., collaboration on open source projects) -* Training and further education within the scope of iSAQB Advanced Level training courses with a minimum of 70 credit points from at least three different areas of competence -* Successful completion of the CPSA-A certification exam -// end::EN[] - -{empty} + -{empty} + - -[.text-center] -image:00-preamble/cpsa-a-logo.png[pdfwidth=50%,align=center,alt="Certified Professional for Software Architecture^(R)^ Advanced Level (CPSA-A)"] - diff --git a/docs/00b-basics/00-basics.adoc b/docs/00b-basics/00-basics.adoc deleted file mode 100644 index 79711f3..0000000 --- a/docs/00b-basics/00-basics.adoc +++ /dev/null @@ -1,17 +0,0 @@ -// header file for curriculum section 1: Basic Concepts -// (c) iSAQB e.V. (https://isaqb.org) -// ==================================================== - -== {basics} - -include::01-what-to-expect-of-this-module.adoc[{include_configuration}] - -include::02-curriculum-structure-and-chronological-breakdown.adoc[{include_configuration}] - -include::03-timing-didactics-and-more.adoc[{include_configuration}] - -include::04-prerequisites-for-this-training.adoc[{include_configuration}] - -include::05-curriculum-outline.adoc[{include_configuration}] - -include::06-complementary-information.adoc[{include_configuration}] diff --git a/docs/00b-basics/01-what-to-expect-of-this-module.adoc b/docs/00b-basics/01-what-to-expect-of-this-module.adoc deleted file mode 100644 index a888ecb..0000000 --- a/docs/00b-basics/01-what-to-expect-of-this-module.adoc +++ /dev/null @@ -1,20 +0,0 @@ -// tag::DE[] -=== Was vermittelt das Modul „{curriculum-short}“? - -Das Modul präsentiert den Teilnehmerinnen und Teilnehmern {curriculum-name} als … -Am Ende des Moduls kennen die Teilnehmerinnen und Teilnehmer … und können … -// end::DE[] - -// tag::EN[] -=== What does the module “{curriculum-short}” convey? - -The module presents {curriculum-short} to the participants … -At the end of the module, the participants know … and are able to … -// end::EN[] - - -[NOTE] -==== -Hier bitte das Modul bzw. dessen Lerninhalte zusammenfassend in 5-8 Sätzen beschreiben. Dabei `{curriculum-name}` -nicht entfernen, beim Zusammenbauen wird dieser Platzhalter mit dem Modulnamen ersetzt. -==== diff --git a/docs/00b-basics/02-curriculum-structure-and-chronological-breakdown.adoc b/docs/00b-basics/02-curriculum-structure-and-chronological-breakdown.adoc deleted file mode 100644 index 0e8e7f5..0000000 --- a/docs/00b-basics/02-curriculum-structure-and-chronological-breakdown.adoc +++ /dev/null @@ -1,47 +0,0 @@ -// tag::DE[] -=== Struktur des Lehrplans und empfohlene zeitliche Aufteilung - -[cols="<,>", options="header"] -|=== -| Inhalt | Empfohlene Mindestdauer (min) -| 1. Thema mit Einleitung | 180 -| 2. Thema über xz | 150 -| 3. Thema mit viel Theorie | 120 -| 4. Thema mit xy und Beispiel | 180 -| 5. Thema mit abc und d | 210 -| 6. Thema mit Abschlussbeispiel | 120 -| | -| Summe | 960 (16h) - -|=== - -// end::DE[] - -// tag::EN[] -=== Curriculum Structure and Recommended Durations - -[cols="<,>", options="header"] -|=== -| Content -| Recommended minimum duration (minutes) -| 1. Introduction | 180 -| 2. xz | 150 -| 3. Lots of theory | 120 -| 4. xy and example | 180 -| 5. abc und d | 210 -| 6. Final example | 120 -| | -| Total | 960 (16h) - -|=== - -// end::EN[] - -[NOTE] -==== -Bitte die oben angegebene Tabelle entsprechend anpassen. - -= = = - -Please adjust the table above according to your curriculum. -==== diff --git a/docs/00b-basics/03-timing-didactics-and-more.adoc b/docs/00b-basics/03-timing-didactics-and-more.adoc deleted file mode 100644 index 16b3da5..0000000 --- a/docs/00b-basics/03-timing-didactics-and-more.adoc +++ /dev/null @@ -1,49 +0,0 @@ - -[NOTE] -==== -Bitte in dieser Datei nur die "**?**"-Platzhalter durch die Anzahl der Tage sowie die erreichbaren Punkte ersetzen. Ansonsten keine Änderungen vornehmen! -==== - - -:recommended-duration-in-days: **?** -:methodical-credits: **?** -:technical-credits: **?** -:communicative-credits: **?** - -// tag::DE[] -=== Dauer, Didaktik und weitere Details - -Die unten genannten Zeiten sind Empfehlungen. Die Dauer einer Schulung zum Modul {curriculum-short} -sollte mindestens {recommended-duration-in-days} Tage betragen, kann aber länger sein. -Anbieter können sich durch Dauer, Didaktik, Art und Aufbau der Übungen sowie der detaillierten Kursgliederung voneinander unterscheiden. -Insbesondere die Art der Beispiele und Übungen lässt der Lehrplan komplett offen. - -Lizenzierte Schulungen zu {curriculum-short} tragen zur Zulassung zur abschließenden Advanced-Level-Zertifizierungsprüfung folgende Credit Points) bei: - -[stripes=none, frame=none, grid=rows] -|=== -| Methodische Kompetenz: | {methodical-credits} Punkte -| Technische Kompetenz: | {technical-credits} Punkte -| Kommunikative Kompetenz: | {communicative-credits} Punkte -|=== - -// end::DE[] - -// tag::EN[] -=== Duration, Teaching Method and Further Details - -The times stated below are recommendations. -The duration of a training course on the {curriculum-short} module should be at least {recommended-duration-in-days} days, but may be longer. -Providers may differ in terms of duration, teaching method, type and structure of the exercises, and the detailed course structure. -In particular, the curriculum provides no specifications on the nature of the examples and exercises. - -Licensed training courses for the {curriculum-short} module contribute the following credit points towards admission to the final Advanced Level certification exam: - -[stripes=none, frame=none, grid=rows] -|=== -| Methodical Competence: | {methodical-credits} Points -| Technical Competence: | {technical-credits} Points -| Communicative Competence: | {communicative-credits} Points -|=== - -// end::EN[] diff --git a/docs/00b-basics/04-prerequisites-for-this-training.adoc b/docs/00b-basics/04-prerequisites-for-this-training.adoc deleted file mode 100644 index 1cc4670..0000000 --- a/docs/00b-basics/04-prerequisites-for-this-training.adoc +++ /dev/null @@ -1,40 +0,0 @@ -// tag::DE[] -=== Voraussetzungen - -Teilnehmerinnen und Teilnehmer **sollten** folgende Kenntnisse und/oder Erfahrung mitbringen: - -- Voraussetzung 1 -- Voraussetzung 2, etc. - -**Hilfreich** für das Verständnis einiger Konzepte sind darüber hinaus: - -- Kenntnisgruppe 1: - * Kenntnis 1 - * Erfahrung 2 - * Kenntnis 3 - * Erfahrung 4 - * Wissen 5 -// end::DE[] - -// tag::EN[] -=== Prerequisites - -Participants **should** have the following prerequisite knowledge: - -- Prerequisite 1 -- Prerequisite 2, etc. - -Knowledge in the following areas may be **helpful** for understanding some concepts: - -- Area 1: - * Knowledge 1 - * Experience 2 - * Knowledge 3 - * Experience 4 - * Understanding 5 -// end::EN[] - -[NOTE] -==== -Kenntnisgruppen sowie Voraussetzungen bitte entsprechend ausformulieren! -==== diff --git a/docs/00b-basics/05-curriculum-outline.adoc b/docs/00b-basics/05-curriculum-outline.adoc deleted file mode 100644 index 6c2f04e..0000000 --- a/docs/00b-basics/05-curriculum-outline.adoc +++ /dev/null @@ -1,24 +0,0 @@ -// tag::DE[] -=== Gliederung des Lehrplans - -Die einzelnen Abschnitte des Lehrplans sind gemäß folgender Gliederung beschrieben: - -- **Begriffe/Konzepte**: Wesentliche Kernbegriffe dieses Themas. -- **Unterrichts-/Übungszeit**: Legt die Unterrichts- und Übungszeit fest, die für dieses Thema bzw. dessen Übung in einer akkreditierten Schulung mindestens aufgewendet werden muss. -- **Lernziele**: Beschreibt die zu vermittelnden Inhalte inklusive ihrer Kernbegriffe und -konzepte. - -Dieser Abschnitt skizziert damit auch die zu erwerbenden Kenntnisse in entsprechenden Schulungen. -// end::DE[] - -// tag::EN[] -=== Structure of the Curriculum - -The individual sections of the curriculum are described according to the following structure: - -- **Terms/principles**: Essential core terms of this topic. -- **Teaching/practice time**: Defines the minimum amount of teaching and practice time that must be spent on this topic or its practice in an accredited training course. -- **Learning goals**: Describes the content to be conveyed including its core terms and principles. - -This section therefore also outlines the skills to be acquired in corresponding training courses. -// end::EN[] - diff --git a/docs/00b-basics/06-complementary-information.adoc b/docs/00b-basics/06-complementary-information.adoc deleted file mode 100644 index 0c0784b..0000000 --- a/docs/00b-basics/06-complementary-information.adoc +++ /dev/null @@ -1,12 +0,0 @@ -// tag::DE[] -=== Ergänzende Informationen, Begriffe, Übersetzungen - -Soweit für das Verständnis des Lehrplans erforderlich, haben wir Fachbegriffe ins https://github.com/isaqb-org/glossary[iSAQB-Glossar] aufgenommen, definiert und bei Bedarf durch die Übersetzungen der Originalliteratur ergänzt. - -// end::DE[] - -// tag::EN[] -=== Supplementary Information, Terms, Translations - -To the extent necessary for understanding the curriculum, we have added definitions of technical terms to the https://github.com/isaqb-org/glossary[iSAQB glossary] and complemented them by references to (translated) literature. -// end::EN[] diff --git a/docs/01-module-block-1/00-structure.adoc b/docs/01-module-block-1/00-structure.adoc deleted file mode 100644 index 2966359..0000000 --- a/docs/01-module-block-1/00-structure.adoc +++ /dev/null @@ -1,20 +0,0 @@ -// header file for curriculum section 1: ERSTE LERNEINHEIT -// (c) iSAQB e.V. (https://isaqb.org) -// ==================================================== - - -// tag::DE[] -== Dies ist der Titel des ersten Moduls -// end::DE[] - -// tag::EN[] -== This is the First Module's Title -// end::EN[] - - -include::01-duration-terms.adoc[{include_configuration}] - -include::02-learning-goals.adoc[{include_configuration}] - -// references (if any!) -include::references.adoc[{include_configuration}] diff --git a/docs/01-module-block-1/01-duration-terms.adoc b/docs/01-module-block-1/01-duration-terms.adoc deleted file mode 100644 index 4b289d5..0000000 --- a/docs/01-module-block-1/01-duration-terms.adoc +++ /dev/null @@ -1,29 +0,0 @@ -// tag::DE[] -|=== -| Dauer: XXX Min. | Übungszeit: XXX Min. -|=== - -=== Begriffe und Konzepte -Begriff 1, Begriff 2, Begriff 3 - -// end::DE[] - -// tag::EN[] -|=== -| Duration: XXX min | Practice time: XXX min -|=== - -=== Terms and Principles -Term 1, Term 2, Term 3 -// end::EN[] - - -[NOTE] -==== -Überschrift in 00-structure.adoc ersetzen -==== - -[NOTE] -==== -Sinnvolle Zeiten für Dauer und Übungszeit eintragen, vernünftige Begriffe aufzählen. -==== diff --git a/docs/01-module-block-1/02-learning-goals.adoc b/docs/01-module-block-1/02-learning-goals.adoc deleted file mode 100644 index a6efecc..0000000 --- a/docs/01-module-block-1/02-learning-goals.adoc +++ /dev/null @@ -1,26 +0,0 @@ -=== {learning-goals} - -// tag::DE[] -[[LZ-1-1]] -==== LZ 1-1: Dies ist das erste Lernziel, in Kategorie xy -Hier wird beschrieben, was Teilnehmer:innen in diesem Lernziel lernen sollen. Das kann in Prosa-Text -in ganzen Sätzen oder in Aufzählungen mit Unterpunkten erfolgen. Dabei kann auch unterschieden werden, -wie wichtig einzelne Aspekte des Lernziels sind. Es kann hier bereits auf Literatur verwiesen werden. - -* Erstes Teilziel -* Zweites Unterthema -* Dritter Aspekt - - -// end::DE[] - -// tag::EN[] -[[LG-1-1]] -==== LG 1-1: The is the first learning goal, in category xy -tbd. -// end::EN[] - -[NOTE] -==== -Die einzelnen Lernziele müssen nicht als einfache Aufzählungen mit Unterpunkten aufgeführt werden, sondern können auch gerne in ganzen Sätzen formuliert werden, welche die einzelnen Punkte (sofern möglich) integrieren. -==== diff --git a/docs/01-module-block-1/references.adoc b/docs/01-module-block-1/references.adoc deleted file mode 100644 index 8fb3e41..0000000 --- a/docs/01-module-block-1/references.adoc +++ /dev/null @@ -1,14 +0,0 @@ -=== {references} - -<>, <>, <>, <> - - - -[NOTE] -==== -Eine Quelle wird über `\<