extract criteria

isaqb-org · Oct 7, 2023 · ca8bf06 · ca8bf06
1 parent 81c37c3
commit ca8bf06
Show file tree

Hide file tree

Showing 14 changed files with 158 additions and 202 deletions.
diff --git a/docs/03-examination-procedure/01-submit-topic.adoc b/docs/03-examination-procedure/01-submit-topic.adoc
@@ -6,9 +6,16 @@ Bei Akzeptanz gibt er/sie das Thema frei.
 Das Thema steht dann auf der Website des iSAQB für die Bewerbung zur Verfügung.
 Sollte ein Thema abgelehnt werden, kann es nachgebessert und dem/der Themenverwalter:in erneut vorgelegt werden.
 
+include::../05-criteria/02-criteria-new-topic.adoc[{include_configuration}]
+
 // end::DE[]
 
 // tag::EN[]
 === Submit Topic (optional)
 The submission of a topic takes place on the iSAQB website via a form. The topic administrator assesses the submitted topic formally and in terms of content within one month. On acceptance, they approve the topic. The topic is then available for application on the iSAQB website. If a topic is rejected, it can be improved and submitted to the topic administrator again.
+
+include::../05-criteria/02-criteria-new-topic.adoc[{include_configuration}]
+
 // end::EN[]
+
+
diff --git a/docs/03-examination-procedure/05-create-roadmap.adoc b/docs/03-examination-procedure/05-create-roadmap.adoc
@@ -4,44 +4,7 @@ Die Themenarbeitsgruppe erstellt eine Roadmap, in der sie inhaltlich und zeitlic
 Der/die Themenmoderator:in kann hierbei unterstützen.
 Schließlich wird die Roadmap bei dem/der Themenmoderator:in eingereicht, welche:r diese anhand festgelegter Kriterien überprüft.
 
-==== Kriterien für die Abnahme der Roadmap
-[cols="<3,<1,<7a"]
-|===
-| Kriterium | Pflicht | Beschreibung
-
-| Ziel, Mission
-| Muss
-| - Sind Ziel und Mission der Themenarbeitsgruppe verständlich beschrieben?
-
-| Themenarbeitsgruppe
-| Muss
-| - Sind die Kontaktdaten aller Mitglieder der Themenarbeitsgruppe angeführt?
-
-| Vorgehensweise
-| Muss
-|- Werden die Rollen und Aufgaben der Mitglieder der Themenarbeitsgruppe beschrieben?
-- Ist ein Zeitplan mit Meilensteinen vorhanden?
-- Sind die Zeiten und Orte für die optionalen persönlichen Treffen angeführt?
-- Sind die Zeiten und Mittel für die virtuellen Treffen angeführt?
-- Werden die Werkzeuge für die elektronische Kommunikation aufgelistet?
-- Sind Arbeitspakete und Zuständigkeiten definiert?
-- Ist der Review-Prozess bestimmt?
-
-| Literatur
-| Muss
-| - Gibt es eine Literaturliste?
-- Umfasst die Literaturliste mindestens 7 Quellen?
-- Sind die Quellen von wissenschaftlichem Wert?
-
-| Ergebnisse
-| Muss
-| - Wird der verpflichtende Artikel diskutiert?
-- Wird zumindest ein weiteres Ergebnis angeführt (z.{nbsp}B. Anleitung, Beispiel, ...)?
-- Wird für jedes Ergebnis die Form und Struktur behandelt?
-- Versucht die Themenarbeitsgruppe, die Ergebnisse bei mindestens einer Konferenz zu präsentieren?
-- Versucht die Themenarbeitsgruppe, die Ergebnisse in zumindest einer Fachzeitschrift zu publizieren?
-
-|===
+include::../05-criteria/05-criteria-roadmap.adoc[{include_configuration}]
 
 Gibt der/die Themenmoderator:in die Roadmap frei, kann die Themenarbeitsgruppe mit der Umsetzung beginnen.
 Bei Ablehnung der Roadmap hat die Themenarbeitsgruppe einen weiteren Versuch, die Roadmap zu verbessern und erneut abzugeben.
@@ -52,43 +15,7 @@ Bei Ablehnung der Roadmap hat die Themenarbeitsgruppe einen weiteren Versuch, di
 === Step 4: Create Roadmap
 The topic working group creates a roadmap, in which they put down in writing their plan for their procedure in terms of content and timescale. The topic moderator can provide assistance here. The roadmap is ultimately submitted to the topic moderator, who assesses this based on specified criteria.
 
-[cols="<3,<1,<7a"]
-|===
-| Criterion | Requirement | Description
-
-| Objective, mission
-| Essential
-| - Are the objective and mission of the topic working group described comprehensibly?
-
-| Topic working group
-| Essential
-| - Are the contact details of all members of the topic working group stated?
-
-| Procedure
-| Essential
-| - Are the roles and tasks of the members of the topic working group described?
-- Is a timetable with milestones provided?
-- Are the times and locations for the optional in-person meetings stated?
-- Are the times and resources for the virtual meetings stated?
-- Are the tools for electronic communication listed?
-- Are work packages and responsibilities defined?
-- Is the review process determined?
-
-| Literature
-| Essential
-| - Is there a bibliography?
-- Does the bibliography comprise at least 7 sources?
-- Are the sources of academic value?
-
-| Results
-| Essential
-| - Is the mandatory article discussed?
-- Is at least one additional result stated (e.g., instructions, example, ...)?
-- Are the form and structure discussed for each result?
-- Does the topic working group attempt to presentthe results at at least one conference?
-- Does the topic working group attempt to publish the results in at least one trade publication?
-
-|===
+include::../05-criteria/05-criteria-roadmap.adoc[{include_configuration}]
 
 If the topic moderator approves the roadmap, the topic working group can begin with implementation. If the roadmap is rejected, the topic working group has one further attempt to improve and re-submit the roadmap.
 

diff --git a/docs/04-certification/01-submit-result.adoc b/docs/04-certification/01-submit-result.adoc
@@ -3,17 +3,18 @@
 Ist die Roadmap erfüllt, gibt die Themenarbeitsgruppe ihre Ergebnisse bei dem/der Themenmoderator:in ab.
 Er/sie prüft die Ergebnisse auf formelle Kriterien und fordert gegebenenfalls noch Nachbesserungen ein.
 
-==== Formelle Kriterien
-include::../05-criteria/06-criteria-form-table.adoc[{include_configuration}]
+Mit den nachfolgenden Kriterien prüft der/die Themenmoderator:in die Ergebnisse einer Themenarbeitsgruppe.
+
+include::../05-criteria/06-criteria-formal.adoc[{include_configuration}]
 
 // end::DE[]
 
 // tag::EN[]
 === Submission
 Once the roadmap has been fulfilled, the topic working group submits its results to the topic moderator. They assess the results according to formal criteria and, if necessary, request corrections.
 
-==== Formal criteria
-include::../05-criteria/06-criteria-form-table.adoc[{include_configuration}]
+With the following criteria the topic moderator checks the results of a topic working group.
 
+include::../05-criteria/06-criteria-formal.adoc[{include_configuration}]
 
 // end::EN[]
diff --git a/docs/04-certification/02-examination-performance.adoc b/docs/04-certification/02-examination-performance.adoc
@@ -27,12 +27,9 @@ Zur Zertifizierung muss eine Themenarbeitsgruppe folgende Ergebnisse abgeben:
 Die Themenarbeitsgruppe genehmigt dem iSAQB die Veröffentlichung ihrer Ergebnisse. _Ebenso kann jedes Mitglied der Themenarbeitsgruppe die Ergebnisse unter Angabe der Mitwirkenden und des iSAQB frei verwerten. (Siehe Punkt E.5 der FAQs > Formulierung wird wahrscheinlich nochmal angepasst.)_ Das iSAQB veröffentlicht unter Benennung aller Beteiligten den Artikel auf seinen Seiten und übersetzt diesen in verschiedene Sprachen.
 
 ==== Beurteilung
-Die gemeinsame Beurteilung der Prüfer:innen erfolgt nach dem folgenden Kriterienkatalog.
-Es müssen mindestens 20 der 30 Punkte erreicht werden.
-In jeder Kategorie müssen 4 der 10 Punkte erreicht werden.
-Für jedes Kriterium können die Prüfer:innen eine Begründung angeben.
+Die gemeinsame Beurteilung der Prüfer:innen erfolgt nach dem folgenden Kriterienkatalog. Es müssen mindestens 20 der 30 Punkte erreicht werden. In jeder Kategorie müssen 4 der 10 Punkte erreicht werden. Für jedes Kriterium können die Prüfer:innen eine Begründung angeben.
 
-include::../05-criteria/07-criteria-content-table.adoc[{include_configuration}]
+include::../05-criteria/07-criteria-content.adoc[{include_configuration}]
 
 Sechs Wochen nachdem die Themenarbeitsgruppe die Ergebnisse eingereicht hat, bekommen die Mitglieder über den Zertifizierer das Ergebnis mitgeteilt:
 Erfolgreiche Zertifizierung, Ablehnung oder Nachbesserung nötig.
@@ -73,7 +70,7 @@ The topic working group permits iSAQB to publish their results. Each member of t
 ==== Assessment
 The joint assessment of the examiners takes place according to the following catalog of criteria. At least 20 of the 30 points must be achieved. 4 out of 10 points must be achieved in each category. The examiners can provide justification for each criterion.
 
-include::../05-criteria/07-criteria-content-table.adoc[{include_configuration}]
+include::../05-criteria/07-criteria-content.adoc[{include_configuration}]
 
 Six weeks after the topic working group has submitted the results, the members are informed of the result by the certifying body: Successful certification, rejection, or correction required. The topic working group gains insight into the justification for the examination results.
 

diff --git a/docs/05-criteria/00-structure.adoc b/docs/05-criteria/00-structure.adoc
@@ -26,7 +26,7 @@ include::05-criteria-roadmap.adoc[{include_configuration}]
 
 <<<
 
-include::06-criteria-form.adoc[{include_configuration}]
+include::06-criteria-formal.adoc[{include_configuration}]
 
 <<<
 

diff --git a/docs/05-criteria/01-accreditation.adoc b/docs/05-criteria/01-accreditation.adoc
@@ -46,6 +46,6 @@ Zur Akkreditierung muss ein:e Themenmoderator:in folgende Kriterien erfüllen:
 
 // tag::EN[]
 === Accreditation
-
+TODO
 
 // end::EN[]
diff --git a/docs/05-criteria/02-criteria-new-topic.adoc b/docs/05-criteria/02-criteria-new-topic.adoc
@@ -1,5 +1,5 @@
 // tag::DE[]
-=== Kriterien für ein neues Thema
+==== Kriterien für ein neues Thema
 
 Ein neues Thema muss folgende Kriterien erfüllen:
 
@@ -30,7 +30,7 @@ Ist das Thema noch nicht vollständig und öffentlich bearbeitet (z.{nbsp}B. Wik
 |Ist zu erwarten, dass durch die Themenbearbeitung die Arbeit in der Softwarearchitektur zukünftig vereinfacht oder beschleunigt werden kann?
 
 |Problemlösend
-|Must
+|Muss
 |Können durch die Themenbearbeitung wiederkehrende und bisher scheinbar unüberwindliche Probleme in der Softwarearchitektur gelöst werden?
 
 Beispiele:
@@ -44,7 +44,7 @@ Beispiele:
 // end::DE[]
 
 // tag::EN[]
-=== Criteria for a new Topic
+==== Criteria for a new Topic
 
 A new topic must meet the following criteria:
 

diff --git a/docs/05-criteria/03-criteria-new-applicant.adoc b/docs/05-criteria/03-criteria-new-applicant.adoc
@@ -1,5 +1,5 @@
 // tag::DE[]
-=== Kriterien für neue Bewerber:innen
+==== Kriterien für neue Bewerber:innen
 Bewerber:innen müssen folgende Kriterien erfüllen, um in einer Themenarbeitsgruppe mitarbeiten zu dürfen:
 
 [cols="<3,<7a"]
@@ -43,11 +43,10 @@ Das iSAQB^®^ kann aktiv Koryphäen einladen, in einer Themenarbeitsgruppe mitzu
 Auch Koryphäen müssen in Themenarbeitsgruppen mitarbeiten. Ohne Mitarbeit in einer Themenarbeitsgruppe und einer erfolgreichen Zertifizierung erhält niemand das EL-Zertifikat.
 ====
 
-
 // end::DE[]
 
 // tag::EN[]
-=== Criteria for New Applicants
-
+==== Criteria for New Applicants
+TODO
 
 // end::EN[]
diff --git a/docs/05-criteria/04-criteria-new-moderator.adoc b/docs/05-criteria/04-criteria-new-moderator.adoc
@@ -1,5 +1,5 @@
 // tag::DE[]
-=== Kriterien für neue Themenmoderator:innen
+==== Kriterien für neue Themenmoderator:innen
 Ein:e Themenmoderator:in muss diese Kriterien erfüllen:
 
 [cols="<3,2,<7a"]
@@ -33,7 +33,7 @@ Ein:e Themenmoderator:in muss diese Kriterien erfüllen:
 // end::DE[]
 
 // tag::EN[]
-=== Criteria for New Moderators
-
+==== Criteria for New Moderators
+TODO
 
 // end::EN[]
diff --git a/docs/05-criteria/05-criteria-roadmap.adoc b/docs/05-criteria/05-criteria-roadmap.adoc
@@ -1,50 +1,86 @@
 // tag::DE[]
-=== Kriterien für eine Roadmap
 
-
-[cols="<2,1,<7a"]
+==== Kriterien für die Abnahme der Roadmap
+[cols="<3,<1,<7a"]
 |===
 | Kriterium | Pflicht | Beschreibung
 
-|Ziel, Mission
-|Muss
-|Sind Ziel und Mission der Themenarbeitsgruppe verständlich beschrieben?
+| Ziel, Mission
+| Muss
+| - Sind Ziel und Mission der Themenarbeitsgruppe verständlich beschrieben?
 
-|Themenarbeitsgruppe
-|Muss
-|Sind die Kontaktdaten aller Bewerber:innen angeführt?
+| Themenarbeitsgruppe
+| Muss
+| - Sind die Kontaktdaten aller Mitglieder der Themenarbeitsgruppe angeführt?
 
-|Vorgehensweise
-|Muss
-|- Werden die Rollen und Aufgaben der Bewerber:innen beschrieben?
+| Vorgehensweise
+| Muss
+|- Werden die Rollen und Aufgaben der Mitglieder der Themenarbeitsgruppe beschrieben?
 - Ist ein Zeitplan mit Meilensteinen vorhanden?
 - Sind die Zeiten und Orte für die optionalen persönlichen Treffen angeführt?
 - Sind die Zeiten und Mittel für die virtuellen Treffen angeführt?
 - Werden die Werkzeuge für die elektronische Kommunikation aufgelistet?
 - Sind Arbeitspakete und Zuständigkeiten definiert?
 - Ist der Review-Prozess bestimmt?
 
-|Literatur
-|Muss
-|- Gibt es eine Literaturliste?
-- Umfasst die Literaturliste mindestens sieben Quellen?
+| Literatur
+| Muss
+| - Gibt es eine Literaturliste?
+- Umfasst die Literaturliste mindestens 7 Quellen?
 - Sind die Quellen von wissenschaftlichem Wert?
 
-|Ergebnisse
-|Muss
-|- Wird der verpflichtende Artikel diskutiert?
-- Wird zumindest ein weiteres Ergebnis angeführt (z. B. Anleitung, Beispiel, Muster, Vorlesung an einer Hochschule, ...)?
+| Ergebnisse
+| Muss
+| - Wird der verpflichtende Artikel diskutiert?
+- Wird zumindest ein weiteres Ergebnis angeführt (z.{nbsp}B. Anleitung, Beispiel, ...)?
 - Wird für jedes Ergebnis die Form und Struktur behandelt?
 - Versucht die Themenarbeitsgruppe, die Ergebnisse bei mindestens einer Konferenz zu präsentieren?
 - Versucht die Themenarbeitsgruppe, die Ergebnisse in zumindest einer Fachzeitschrift zu publizieren?
 
 |===
 
-
 // end::DE[]
 
 // tag::EN[]
-=== Criteria for a Roadmap
+==== Criteria for a Roadmap
+
+[cols="<3,<1,<7a"]
+|===
+| Criterion | Requirement | Description
+
+| Objective, mission
+| Essential
+| - Are the objective and mission of the topic working group described comprehensibly?
+
+| Topic working group
+| Essential
+| - Are the contact details of all members of the topic working group stated?
+
+| Procedure
+| Essential
+| - Are the roles and tasks of the members of the topic working group described?
+- Is a timetable with milestones provided?
+- Are the times and locations for the optional in-person meetings stated?
+- Are the times and resources for the virtual meetings stated?
+- Are the tools for electronic communication listed?
+- Are work packages and responsibilities defined?
+- Is the review process determined?
+
+| Literature
+| Essential
+| - Is there a bibliography?
+- Does the bibliography comprise at least 7 sources?
+- Are the sources of academic value?
+
+| Results
+| Essential
+| - Is the mandatory article discussed?
+- Is at least one additional result stated (e.g., instructions, example, ...)?
+- Are the form and structure discussed for each result?
+- Does the topic working group attempt to presentthe results at at least one conference?
+- Does the topic working group attempt to publish the results in at least one trade publication?
+
+|===
 
 
 // end::EN[]
diff --git a/docs/05-criteria/06-criteria-form.adoc b/docs/05-criteria/06-criteria-form.adoc
diff --git a/docs/05-criteria/06-criteria-form-table.adoc → docs/05-criteria/06-criteria-formal.adoc b/docs/05-criteria/06-criteria-form-table.adoc → docs/05-criteria/06-criteria-formal.adoc
@@ -1,5 +1,7 @@
 // tag::DE[]
 
+==== Formelle Kriterien
+
 [cols="<3,<1,<7a"]
 |===
 | Kriterium | Pflicht | Beschreibung
@@ -85,6 +87,9 @@
 
 // tag::EN[]
 
+
+==== Formal Criteria
+
 [cols="<3,<1,<7a"]
 |===
 | Criterion | Requirement | Description
-Original file line number
+Diff line change
@@ Expand Up / @@ -26,7 +26,7 @@ include::05-criteria-roadmap.adoc[{include_configuration}] @@
     <<<
-    include::06-criteria-form.adoc[{include_configuration}]
+    include::06-criteria-formal.adoc[{include_configuration}]
     <<<
@@ Expand Down @@