docs voor simple submission constraints

SELab-2 · May 23, 2024 · 610854f · 610854f
1 parent db1863f
commit 610854f
Show file tree

Hide file tree

Showing 10 changed files with 57 additions and 0 deletions.
diff --git a/docs/images/bestand_veranderen.png b/docs/images/bestand_veranderen.png
diff --git a/docs/images/extensie_niet_aanwezig.png b/docs/images/extensie_niet_aanwezig.png
diff --git a/docs/images/file_indiening.png b/docs/images/file_indiening.png
diff --git a/docs/images/global.png b/docs/images/global.png
diff --git a/docs/images/hover_zip.png b/docs/images/hover_zip.png
diff --git a/docs/images/map_bestand_lokaal.png b/docs/images/map_bestand_lokaal.png
diff --git a/docs/images/niet_aanwezig.png b/docs/images/niet_aanwezig.png
diff --git a/docs/images/voorbeeld.png b/docs/images/voorbeeld.png
diff --git a/docs/images/zip_indiening.png b/docs/images/zip_indiening.png
diff --git a/docs/simple_constraints.md b/docs/simple_constraints.md
@@ -0,0 +1,57 @@
+# Project Aanmaken: Simpele Structuur Beperkingen
+
+Docenten kunnen de volledige structuur van een opdracht vastleggen. Ze kunnen de studenten echter ook enige vrijheid bieden, indien gewenst.
+
+Een lesgever kan beslissen of de opdracht een enkel bestand moet zijn of een zip-archief met meerdere bestanden.
+
+## Een bestand als indiening
+
+Wanneer de indiening een enkel bestand betreft, moet de lesgever de naam van dit bestand vastleggen.
+
+![File indiening](images/file_indiening.png)
+
+## Een zip-archief als indiening
+
+Wanneer de indiening een zip-archief betreft, moet de lesgever ook de naam van dit archief vastleggen.
+
+![File indiening](images/zip_indiening.png)
+
+Naast de naam van het archief kan de volledige interne structuur worden vastgelegd. Er kan echter ook volledige vrijheid worden gegeven, of iets ertussenin.
+
+Door met de muis over het archief te slepen, kunnen er bestanden of mappen aan worden toegevoegd:
+
+![hover_zip.png](images/hover_zip.png)
+
+Namen die vetgedrukt zijn, stellen mappen voor. Namen in normale tekst zijn bestanden.
+
+![map_bestand_lokaal.png](images/map_bestand_lokaal.png)
+
+Lesgevers die nog meer controle willen over de indiening, kunnen met hun muis over de bestanden of mappen hoveren en op de drie puntjes klikken:
+
+![bestand_veranderen.png](images/bestand_veranderen.png)
+
+Door op `FOLDER` te klikken, kan een bestand worden veranderd in een map, zoals `mijn_map`.
+
+`NIET_AANWEZIG` zorgt ervoor dat dit bestand niet aanwezig mag zijn in de map waarin de beperking is gedefinieerd (hier `archief_naam.zip`), maar mogelijk wel in andere mappen:
+
+![niet_aanwezig.png](images/niet_aanwezig.png)
+
+`EXTENSIE_NIET_AANWEZIG` zorgt ervoor dat een bepaalde extensie niet aanwezig mag zijn in de map of het archief waarin de beperking is gedefinieerd:
+
+![extensie_niet_aanwezig.png](images/extensie_niet_aanwezig.png)
+
+## Globale voorwaarden
+
+Soms is het nodig om een beperking over de volledige indiening te definiëren. Dit kan in de sectie `globale voorwaarden`.
+
+![global.png](images/global.png)
+
+Men kan vastleggen welke bestanden of extensies niet aanwezig mogen zijn met `NIET_AANWEZIG` en `EXTENSIE_NIET_AANWEZIG`. Men kan ook afdwingen dat enkel een bepaalde extensie aanwezig mag zijn over het hele project (mappen niet meegerekend).
+
+## Voorbeeld
+
+![voorbeeld.png](images/voorbeeld.png)
+
+Dit is een zip-indiening waarbij er zeker een extra, src, src/frontend en src/backend map aanwezig moet zijn. In de extra map moet een verslag aanwezig zijn. In de frontend map mag geen node_modules map aanwezig zijn.
+
+Globaal gezien mogen er nergens `.class` bestanden of `malware.exe` aanwezig zijn.