Merge pull request #432 from dodona-edu/updates/dodona-2link2

Updates to manuals

en/references/tested/dsl/index.md

@@ -460,12 +460,12 @@ YAML supports tags to give values another type:
         # An assignment of the variable data.
         - statement: 'data = ["list\nline", "file.txt"]'
           # Function call that uses the variable.
-        - statement: 'function(data, 0.5)'
+        - expression: 'function(data, 0.5)'
           # Expected return value of the function.
           return: [ 0, 0 ]
     - testcases:
         # A function call where the value is cast to "uint8".
-        - statement: 'echo(uint8(5))'
+        - expression: 'echo(uint8(5))'
           # The expected return value is also cast to "uint8".
           return_raw: "uint8(5)"
 

nl/guides/exercises/creating-exercises/exercise/index.md

@@ -37,7 +37,29 @@ Als alles goed gegaan is, werd dit venster leeg.
 
 ## 6. Oefening testen
 
-De oefening die je daarnet gemaakt hebt, kan je terugvinden in [jouw oefeningenrepository](https://dodona.be/nl/repositories/) op Dodona. Test de oefening. Is alles naar wens? Dan kan je bovenaan de oefening publiceren (_Deze oefening publiceren_). Je oefening is nu klaar om te gebruiken op Dodona!
+De oefening die je daarnet gemaakt hebt, kan je terugvinden in [jouw oefeningenrepository](https://dodona.be/nl/repositories/) op Dodona.
+Je nieuwe oefening is nu beschikbaar als _concept_ op Dodona.
+
+Vooraleer je een oefening kan publiceren (uit concept halen), controleert Dodona of aan drie voorwaarden voldaan is:
+
+- De oefening moet een geldig configuratiebestand hebben. 
+- De oefening moet een naam en een beschrijving hebben. 
+- Je moet minstens één correcte oplossing indienen.
+
+Als je deze handleiding gevolgd hebt, zijn aan de eerste twee voorwaarden al voldaan.
+Je moet enkel nog een juiste oplossing indienen, die we al gemaakt hebben.
+Om dit te doen klik je bovenaan de menubalk op het informatie-icoontje:
+
+![Voorbeeldoplossing](./sample-solution.png)
+
+Vervolgens kies je de voorbeeldoplossing die je wilt indienen (hier is er maar een: `solution.py), waarna je op de knop _Deze oplossing indienen_ klikt.
+Dit zal de oefeningenpagina openen met de voorbeeldoplossing ingeladen.
+Je moet enkel nog op indienen klikken.
+
+![Voorbeeldoplossing kiezen](./dodona-submit.png)
+
+Eens de oplossing juist gerekend is, zal je de oefening kunnen publiceren door op _Deze oefening publiceren_ te klikken.
+Je oefening is nu klaar om te gebruiken op Dodona!
 
 ![Minimum oefening](./minimum.png)
 

nl/guides/exercises/creating-exercises/management/index.md

@@ -17,4 +17,19 @@ Hieronder enkele suggesties voor volgende stappen:
 - Maak nog andere soorten oefeningen.
 
 Veel plezier met het gebruik van Dodona!
-Zoals steeds, als je vragen hebt of iets is niet duidelijk, aarzel dan niet om [ons te contacteren](https://dodona.be/nl/contact/).
+
+##  Meer over testplannen
+
+Er zijn verschillende hulpmiddelen voor het gebruiken van testplannen:
+
+- Kijk eens in de [handleiding met veelvoorkomende scenario's](/nl/guides/exercises/testsuites). Vaak staat daar al in wat je wilt doen.
+- Op zoek naar meer informatie over een specifiek onderdeel? Kijk dan in de [referentie voor de testplannen](/nl/references/tested/dsl). Dit is een overzicht van alle mogelijke opties.
+
+## Nog meer vragen?
+
+- Heb je het gevoel dat er een stap ontbreekt of niet duidelijk is in de handleiding?
+- Niet gevonden wat je zocht in de handleidingen of referenties?
+- Onzeker hoe je een testplan voor een bepaalde oefening best aanpakt?
+
+Aarzel dan niet om [ons te contacteren](https://dodona.be/nl/contact/).
+We horen graag alle vragen of suggesties.

nl/guides/exercises/creating-exercises/setup/index.md

@@ -96,6 +96,17 @@ Vul vervolgens de details van de repository in:
 3. **Standaard judge**: kies hier "TESTed".
 4. Klik op de roze knop bovenaan met een vinkje in.
 
+::: tip Wees gerust
+Krijg je bij het kopiëren van de URL een waarschuwing zoals hieronder?
+Dat is geen probleem: je kan deze probleemloos negeren.
+
+![ssh warning](./github-ssh.png)
+
+Deze waarschuwing betekent dat je geen SSH-sleutels in je account hebt.
+Om te werken met Dodona heb je die ook niet nodig.
+Meer informatie over SSH kan je vinden in de GitHub-handleiding [_About SSH_](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/about-ssh).
+:::
+
 ### Webhook instellen
 
 Dodona zal vervolgens je repository ophalen en verwerken.

nl/guides/exercises/examples/_common.md

@@ -14,7 +14,7 @@ Maak daarna, in deze nieuwe map, nog drie mappen:
 De map voor deze oefening moet er als volgt uitzien:
 
 ```
-repository/
+exercises/
 └── minimum/
    ├── evaluation/
    ├── description/
@@ -56,7 +56,7 @@ In dit bestand worden een aantal dingen gespecifieerd:
 Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien:
 
 ```
-repository/
+exercises/
 └── minimum/
    ├── evaluation/
    ├── description/
@@ -103,7 +103,7 @@ def minimum(a, b):
 Nadat je deze twee bestanden gemaakt hebt, moet je repository er zo uitzien:
 
 ```
-repository/
+exercises/
 └── minimum/
    ├── evaluation/
    ├── description/
@@ -152,7 +152,7 @@ In dit testplan gebeuren een aantal dingen:
 Finaal ziet de bestandsstructuur er dus als volgt uit:
 
 ```
-repository/
+exercises/
 └── minimum/
    ├── evaluation/
    |  └── suite.yaml 

nl/guides/exercises/examples/content/index.md

@@ -29,7 +29,7 @@ Maak daarna de map `media` aan in de map `description` waarin de afbeeldingen en
 De map voor deze leesactiviteit moet er als volgt uitzien:
 
 ```
-repository/
+reading-activities//
 └── markdown_demo/
    └── description/
       └── media/
@@ -64,7 +64,7 @@ In dit bestand worden drie dingen gespecifieerd:
 Nadat je dit bestand gemaakt hebt, zal je repository er zo uitzien:
 
 ```
-repository/
+reading-activities//
 └── markdown_demo/
    ├── description/
    |  └── media/
@@ -169,7 +169,7 @@ De inhoud van leesactiviteiten wordt geschreven in Markdown, een redelijk eenvou
 Nadat je deze twee bestanden gemaakt hebt, moet je repository er zo uitzien:
 
 ```
-repository/
+reading-activities//
 └── markdown_demo/
    ├── description/
    |  ├── media/

nl/references/tested/dsl/index.md

@@ -6,15 +6,18 @@ order: 2
 
 # Referentie voor DSL-testplannen
 
+::: tip
+Dit is een referentiegids, voor geavanceerde gebruikers.
+We hebben ook een [reeks handleidingen](/nl/guides/exercises) die uitleggen hoe je oefeningen maakt.
+:::
+
 Een testplan voor TESTed legt vast welke testgevallen uitgevoerd worden op een ingediende oplossing.
 TESTed verschilt van andere judges doordat testplannen niet afhankelijk zijn van één bepaalde programmeertaal.
 Derhalve volstaat één testplan om ingediende oplossingen in verschillende programmeertalen van dezelfde oefening te evalueren.
 
 Naast het [geavanceerde formaat](/nl/references/tested/json) voor testplannen hebben we ook een kleine domeinspecifieke taal (_domain-specific language_, DSL) ontwikkeld om het schrijven van testplannen makkelijker te maken.
 Dit document is de referentiegids voor het formaat van DSL-testplannen en bevat alle opties en mogelijkheden.
 
-[//]: # (We hebben ook een reeks tutorials waar we uitleggen hoe een bepaalde soort oefening opgesteld moet worden.)
-
 DSL-testplannen worden geschreven in YAML.
 Een JSON Schema van het formaat is beschikbaar in de repository van TESTed.
 Dit schema kan zorgen voor automatische controles en automatisch aanvullen in uw tekstverwerker.
@@ -471,12 +474,12 @@ Hieronder staat een testplan waar alle opties gebruikt worden:
         # Een assignment van de variable "data".
         - statement: 'data = ["list\nline", "file.txt"]'
           # Functieoproep waarbij de variabele gebruikt wordt.
-        - statement: 'function(data, 0.5)'
+        - expression: 'function(data, 0.5)'
           # Verwachte returnwaarde van die functie.
           return: [ 0, 0 ]
     - testcases:
         # Een functieoproep waarbij de waarde gecast wordt naar "uint8".
-        - statement: 'echo(uint8(5))'
+        - expression: 'echo(uint8(5))'
           # De verwachte returnwaarde wordt ook gecast naar "uint8".
           return: "uint8(5)"