Development: Document exam exercise submission policies

docs/user/exams/instructors_guide.rst

@@ -202,6 +202,8 @@ During the exam creation and configuration, you can create your exam and configu
 
         Configure the Grading of a Programming Exercise
 
+    - The *Configure Grading* screen also allows the configuration of :ref:`submission policies <configure_submission_policies>`.
+
 .. _register_students:
 
 1.5 Register Students

docs/user/exams/students_guide.rst

@@ -277,6 +277,21 @@ Participating in Programming Exercises
     You can use the |resolve_conflict| button, which is then displayed instead of the submit button, to resolve the conflict within the online code editor.
     This will reset your changes to the latest commit. Manual merging is not possible with the online code editor.
 
+- The instructors can set submission policies, defining the effect of your submissions on your participation. The policies and their effects are as follows:
+
+    - **None** You can submit as many times as you want without any consequences.
+    - **Lock Repository** There's a limit on the number of allowed submissions. Once you exceed the limit, your repository will be locked and further submissions will not be allowed.
+
+        .. figure:: student/submission_policy_lock.png
+            :alt: Effect of the Lock Repository Policy
+            :align: center
+
+    - **Submission Penalty** There's a limit on the number of allowed submissions. Once you exceed the limit, you will be penalized for each additional submission.
+
+        .. figure:: student/submission_policy_penalty.png
+            :alt: Effect of the Submission Penalty Policy
+            :align: center
+
 End Screen
 ^^^^^^^^^^
 - When you are finished with the exercises, or the time runs out you navigate to the *End Screen*.

src/main/webapp/app/feature-overview/feature-overview.component.ts

@@ -2,6 +2,7 @@ import { Component, OnInit } from '@angular/core';
 import { ActivatedRoute } from '@angular/router';
 import { IconProp } from '@fortawesome/fontawesome-svg-core';
 import {
+    faBan,
     faChartPie,
     faCheckSquare,
     faClipboardCheck,
@@ -368,6 +369,16 @@ export class FeatureOverviewComponent implements OnInit {
             '/content/images/feature-overview/instructors/grade_key_editor.png',
         );
 
+        const featureSubmissionPolicy = new Feature(
+            'featureOverview.instructor.feature.submissionPolicy.title',
+            'featureOverview.instructor.feature.submissionPolicy.shortDescription',
+            'featureOverview.instructor.feature.submissionPolicy.descriptionTextOne',
+            faBan,
+            undefined,
+            undefined,
+            '/content/images/feature-overview/instructors/submission-policy-lock-configure-grading.png',
+        );
+
         this.features = [
             featureCreateConductAssess,
             featureConfiguration,
@@ -385,6 +396,7 @@ export class FeatureOverviewComponent implements OnInit {
             featureStatistics,
             featureChecklist,
             featureGradeKey,
+            featureSubmissionPolicy,
         ];
     }
 

src/main/webapp/i18n/de/featureOverview.json

@@ -85,6 +85,11 @@
                     "title": "Notenschlüssel Erstellen",
                     "shortDescription": "Erstelle einen Notenschlüssel mit benutzerdefinierten oder vorgegebenen Notenstufen für einen Kurs oder eine Prüfung.",
                     "descriptionTextOne": "Punkte sind hilfreich, um einzelne Übungen zu bewerten, aber am Ende eines Semesters möchten du und die Studierenden eine Note erhalten. Auf der Notenschlüssel-Seite kannst du für jeden Kurs und jede Prüfung einen Notenschlüssel festlegen und die Notenstufen definieren, indem du die Intervalle, die Mindestnote und die untere/obere Grenze angibst. Der Standard-Notenschlüssel kann auch mit einem einzigen Klick erstellt werden. Artemis kümmert sich dann automatisch um die Zuordnung von Noten zu Notenstufen oder Bonuspunkten und um die Berechnung der Ergebnisstatistik auf der Grundlage der Notenstufen."
+                },
+                "submissionPolicy": {
+                    "title": "Abgaberichtlinie Definieren",
+                    "shortDescription": "Entmutige Versuch-und-Irrtum-Ansätze mit Einreichungsstrafen und Repository-Sperrmaßnahmen.",
+                    "descriptionTextOne": "Abhängig von den Aufgaben und deinem Unterrichtsstil kann es sinnvoll sein, eine Abgaberichtlinie zu definieren. Im Allgemeinen bekämpfen die Richtlinien zur Sperrung des Repositories und zur Bestrafung von Einsendungen Lösungsansätze, die auf Versuch und Irrtum beruhen. Wenn Studierende das Einsende-Limit erreichen, verhindert die erste Methode weitere Einsendungen, während die zweite Methode einen Punktabzug zur Folge hat. Die Abgaberichtlinien werden zunächst bei der Erstellung einer Programmierübung festgelegt und können später in der Benotungskonfiguration der jeweiligen Programmierübung angepasst werden."
                 }
             }
         },

src/main/webapp/i18n/en/featureOverview.json

@@ -85,6 +85,11 @@
                     "title": "Create Grading Keys",
                     "shortDescription": "Create a grading key with custom or default grade steps for a course or an exam.",
                     "descriptionTextOne": "Scores are helpful to assess individual exercises but at the end of a semester you and your students would like to see a standard grade. On the grading key page, you can have a grading key for each course and exam, define the grade steps by specifying intervals, the minimum passing grade and the lower/upper bound inclusivity. The default grading key can also be generated with a single click. Artemis then automatically handles mapping scores to grade steps or bonus points, as well as calculating student result statistics based on grade steps."
+                },
+                "submissionPolicy": {
+                    "title": "Specify Submission Policies",
+                    "shortDescription": "Discourage trial-and-error approaches with submission penalty and lock repository policies.",
+                    "descriptionTextOne": "Depending on the exercises and your teaching style, it might be useful to specify a submission policy. In general, lock repository and submission penalty policies combat trial-and-error solving approaches. When the student reaches the submission limit, the former prevents further submissions, while the latter results in a point deduction. Submission policies are initially specified in the creation process of a programming exercise and can later be adjusted in the grading configuration of the particular programming exercise."
                 }
             }
         },