Migrating guide for students from dodona-docs

.vuepress/config.js

@@ -55,7 +55,7 @@ module.exports = {
         ],
         sidebar: {
           '/nl/news/': getNewsSidebar('nl', 'Nieuws', 'Overzicht'),
-          '/nl/guides/': getGuidesSidebar('nl', 'Handleidingen', 'Overzicht'),
+          '/nl/guides/': getGuidesSidebar('nl', 'Handleidingen', 'Overzicht', 'Overzicht'),
           '/nl/references/': getReferencesSidebar('nl', 'Referenties', 'Overzicht'),
           '/nl/': getGeneralSidebar()
         }
@@ -71,7 +71,7 @@ module.exports = {
         ],
         sidebar: {
           '/en/news/': getNewsSidebar('en', 'News', 'Overview'),
-          '/en/guides/': getGuidesSidebar('en', 'Guides', 'Overview'),
+          '/en/guides/': getGuidesSidebar('en', 'Guides', 'Overview', '[nl] Overzicht'),
           '/en/references/': getReferencesSidebar('en', 'References', 'Overview'),
           '/en/': getGeneralSidebar()
         }
@@ -133,15 +133,29 @@ function getNewsSidebar(lang, groupTitle, FirstItem) {
   ]
 }
 
-function getGuidesSidebar(lang, groupTitle, FirstItem) {
+function getGuidesSidebar(lang, groupTitle, FirstItem, studentGuideItem) {
   return [
     `/${lang}/news/`,
     {
       title: groupTitle,
       collapsable: false,
       sidebarDepth: 2,
+      initialOpenGroupIndex: -1,
       children: [
         ['', FirstItem],
+        {
+          title: 'Van start met Dodona als student',
+          collapsable: false,
+          path: `/${lang}/guides/for-students/`,
+          sidebarDepth: 2,
+          initialOpenGroupIndex: -1,
+          children: [
+            ['for-students/', studentGuideItem],
+            'for-students/login-and-settings/',
+            'for-students/courses/',
+            'for-students/exercises/',
+          ]
+        },
         'getting-started/',
         'pycharm-plugin/',
         'new-exercise-repo/',

.vuepress/styles/index.styl

@@ -5,4 +5,4 @@
  */
 
 .home .hero img
-  max-width 450px!important
+  max-width 450px!important

en/guides/README.md

@@ -14,4 +14,5 @@ Here you'll find a number of guides, primarily focused on teachers.
 * [Creating a judge](creating-a-judge)
 
 ## Only in Dutch
-* [Van start met Dodona](getting-started)
+* [Van start met Dodona als student](for-students)
+* [Van start met Dodona als leerkracht](getting-started)

en/guides/for-students/README.md

@@ -0,0 +1,51 @@
+---
+title: "[nl] Van start met Dodona als student"
+description: "Tutorial: van start met Dodona als student"
+---
+
+::: warning Sorry
+For now, this page is only available in Dutch. Sorry!
+:::
+
+# Van start met Dodona als student
+> Op deze pagina vind je alle informatie om vlot van start te gaan met Dodona als student.
+
+## Wat is Dodona?
+
+Dodona is een online oefenplatform om te leren programmeren. De webapplicatie werd ontwikkeld aan de Universiteit Gent om practica aan grote groepen studenten te ondersteunen. Dodona focust daarom in de eerste plaats op het automatisch testen en geven van feedback op ingediende oplossingen van programmeeroefeningen. Op dit moment ondersteunt Dodona de programmeertalen Python, JavaScript, Java, C#, bash, Prolog, Haskell en R.
+
+Dodona wordt gratis aangeboden voor educatieve doeleinden.
+
+## Opdeling van de handleiding
+
+De handleding is onderverdeeld in drie onderdelen.
+
+* Het eerste deel [Aanmelden & gebruikersinstellingen](./login-and-settings/) legt uit hoe je een gebruikersaccount op Dodona kan aanmaken en hoe je die kan personaliseren.
+* Het tweede onderdeel [Cursussen op Dodona](./courses/) wordt besproken hoe je je kan registreren en uitschrijven voor een cursus, hoe je kan navigeren naar cursus en hoe je de indienstatus moet interpreteren.
+* In het laatste deel [Oefeningen oplossen](./exercises/) bevat alle informatie die te maken heeft met het navigeren naar oefeningen of oplossingen, het indienen van oplossingen en het interpreteren van feedback.
+## Contact opnemen
+
+Als je met vragen zit over de werking van Dodona of als er interessante ideeën bij je opborrelen over hoe we het platform zouden kunnen verbeteren of uitbreiden, neem dan gerust contact met ons op. Alle commentaren en suggesties zijn meer dan welkom. Navigeer daarvoor naar de [contactpagina](https://dodona.ugent.be/nl/contact/) door in de voettekst (onderaan elke pagina) op `Contact` te klikken.
+Vul vervolgens de gegevens in het paneel `Contacteer ons` aan en klik daarna op de verzendknop in de rechterbovenhoek van het paneel.
+
+![image](./contact.nl.png)
+
+
+
+<!-- ---
+    title: Starting with Dodona as a student
+    description: "Tutorial: starting with Dodona as a student"
+    ---
+
+    # Dodona for students
+
+    As a student, you can [register]() for one or more courses. Every course has [exercises]() that are grouped in [series](). For each [exercise]() an arbitrary amount of [solutions]() can be [submitted](). These submissions will automatically be judged and annotated with [feedback](). All the actions mentioned require you to have an [account]() and that you are [logged in]() on Dodona.
+
+    ## Get in touch
+
+    If you have any questions about the way Dodona works or any interesting ideas that you want to share about the extension or enhancement of the platform, don't hesitate to contact us. Any comments and/or suggestions are more than welcome. Contacting us can be done by navigating to the **contact page** by clicking on the `Contact` button in the **footer** (at the bottom of every page).
+
+    ![image](./contact.en.png)
+
+    Fill the information in the panel `Get in touch` and when you are ready press on the send button in the upper right corner of the panel.
+-->

en/guides/for-students/courses/README.md

@@ -0,0 +1,132 @@
+---
+title: "[nl] Cursussen op Dodona"
+description: "Tutorial: cursussen op Dodona"
+---
+
+::: warning Sorry
+For now, this page is only available in Dutch. Sorry!
+:::
+
+# Cursussen op Dodona
+> Op deze pagina vind je alle informatie zodat je je als student kan registreren en uitschrijven voor een cursus, kan navigeren naar een cursus en de indienstatus kan interpreteren.
+
+**Inhoudsopgave**
+[[toc]]
+
+## Wat is een cursus?
+
+Een cursus op Dodona is een leerpad met [oefeningen](../exercises/#navigeren-naar-een-oefening) die gebundeld worden in oefeningenreeksen. Als je voor een cursus geregistreerd bent dan kan je binnen de cursus [oplossingen indienen](../exercises/#indienen-van-een-oplossing) voor de oefeningen.
+
+## Registreren voor een cursus
+
+Om oplossingen voor oefeningen in een cursus te kunnen indienen moet je in die cursus geregistreerd zijn.
+
+### Hoe vind je een cursus?
+
+Eerst moet je de cursus waarvoor je wil registreren vinden. Dit kan je doen door op je startpagina op `MEER CURSUSSEN...` of op `VERKEN CURSUSSEN` te klikken.
+
+![image](./student.explore_courses.png)
+
+Dit zal je naar een [overzicht van alle cursussen](https://dodona.ugent.be/nl/courses/) brengen. Hier kan je de zoekbalk gebruiken om op basis van een cursusnaam, een naam van een lesgever, de naam van je onderwijsinstelling of een academiejaar de juiste cursus kan vinden.
+
+![image](./student.courses.png)
+
+### Hoe registreer je?
+
+Als je navigeert naar de cursus dat je zocht, waarvoor je nog niet geregistreerd bent, dan zie je bovenaan de cursuspagina een paneel dat aangeeft of en hoe je je voor de cursus kan registreren. Hierbij zijn er drie mogelijkheden afhankelijk van hoe de cursus geconfigureerd werd:
+
+-   De cursus werkt met een **open registratieprocedure**, wat betekent dat iedereen zich voor de cursus kan registreren zonder expliciete goedkeuring van een cursusbeheerder. Klik op de knop `REGISTREREN` om je voor de cursus te registreren.
+
+    ![image](./register.png)
+
+<h1 id="registratieverzoek"/>
+
+-   De cursus werkt met een **gemodereerde registratieprocedure**, wat betekent dat je een **registratieverzoek** kunt indienen dat daarna dient goedgekeurd of afgekeurd te worden door een cursusbeheerder. Pas wanneer je registratieverzoek wordt goedgekeurd, ben je ook effectief geregistreerd voor de cursus. Klik op de knop `REGISTRATIEVERZOEK` om een registratieverzoek voor de cursus in te dienen.
+
+    ![image](./moderated_register.png)
+
+    Zolang je registratieverzoek nog niet werd goedgekeurd of afgekeurd door een cursusbeheerder, verschijnt in het paneel bovenaan de cursuspagina de boodschap `Je staat al op de wachtlijst.` en wordt de cursus opgelijst in het paneel `Wachten op goedkeuring` in de rechterkolom van je startpagina.
+
+    ![image](./moderated_waiting.png)
+
+-   De cursus werkt met een **gesloten registratieprocedure**, wat betekent dat je geen [registratieverzoek](#registratieverzoek) kunt indienen voor de cursus. De lesgever laat dus niet toe dat je jezelf kan registreren.
+
+    ![image](./closed_registration.png)
+
+Nadat je geregistreerd bent, wordt de cursus getoond op je gepersonaliseerde startpagina.
+
+Naast de mogelijkheid om zelf naar een cursus te navigeren en op de cursuspagina de registratieprocedure te doorlopen, is het ook mogelijk dat je een registratielink ontvangt van een cursusbeheerder (bijvoorbeeld per email van een lesgever). Door op de registratielink te klikken, wordt de registratieprocedure opgestart voor een specifieke cursus en hoef je dus zelf niet meer naar de cursus te navigeren.
+
+## Cursuscomponenten
+
+Een cursus bestaat uit verschillende componenten. Bovenaan de cursuspagina zie je de beschrijving van een cursus. Daaronder kan je verschillende oefeningenreeksen zien die elk bestaan uit een of meerdere oefeningen.
+
+![image](./student.deadline_series_warning.png)
+
+::: tip Tip
+
+Als je binnen een cursus aan het werken bent dan verschijnt de naam van de cursus naast `Dodona` aan de linkerkant van de navigatiebalk. Door in de navigatiebalk op de naam van de cursus te klikken, navigeer je terug naar de cursuspagina.
+
+![image](./student.breadcrumb_course.png)
+:::
+
+### Oefeningenreeksen
+
+Een oefeningenreeks bestaat uit een beschrijving, een aantal oefeningen en eventueel een **deadline** die ingesteld werd door de cursusbeheerder. Indien er een deadline is ingesteld, dan wordt die weergegeven onder de naam van de oefeningenreeks. Bij weergave van de deadline wordt rekening gehouden met de tijdzone uit je [gebruikersprofiel](../login-and-settings/#instellen-van-persoonlijke-voorkeuren). Deadlines worden in het groen weergegeven als ze nog niet verstreken zijn, en in het rood als ze reeds verstreken zijn.
+
+Als een reeks een deadline heeft, dan worden enkel ingediende oplossingen van voor dat tijdstip in rekening gebracht. Na de deadline kan je dus nog steeds indienen, maar ze tellen mogelijks niet mee voor een eventuele evaluatie. Meer details hierover kan je vinden bij de sectie [indienstatus](#indienstatus).
+
+Onder de naam van een oefeningenreeks staat optioneel een beschrijving, met daaronder een oplijsting van alle oefeningen uit de reeks. De lijst toont voor elke oefening je indienstatus en eventueel de voortgang van de groep. Vóór elke oefening in de lijst staat ook een icoontje dat correspondeert met je indienstatus voor de oefening.
+
+::: tip Belangrijk
+Dezelfde oefening kan voorkomen in meerdere cursussen. Je indienstatus voor de oefening wordt hierbij niet overgenomen. Je moet dus de oefening binnen elke cursus afzonderlijk indienen.
+
+Dezelfde oefening kan ook voorkomen in meerdere oefeningenreeksen van eenzelfde cursus. Hier worden je ingediende opgelossingen wel in rekening genomen alle voorkomens van de oefening. Afhankelijk van de ingestelde deadlines van de reeksen kan de indienstatus wel verschillen. Bij een reeks met een deadline worden namelijk enkel oplossingen die voor de deadline werden ingediend meegeteld.
+:::
+
+In het menu van een oefeningenreeks vind je de volgende opties:
+
+- `Toon overzicht`: Toont een overzicht waarin de namen en beschrijvingen van alle oefeningen uit de oefeningenreeks netjes onder elkaar staan. Onder elke beschrijving staat ook je [indienstatus](#indienstatus) voor de oefening. Als je op de indienstatus drukt dan navigeer je naar de oplossing die gebruikt werd om de indienstatus te bepalen (als je effectief een oplossing hebt ingediend op basis waarvan de indienstatus kon bepaald worden).
+
+- `Oplossing downloaden`: Downloadt een ZIP-bestand dat voor elke oefening uit de oefeningenreeks de oplossing bevat die gebruikt werd om je [indienstatus](#indienstatus) voor de oefening te bepalen (als je effectief een oplossing hebt ingediend op basis waarvan de indienstatus kon bepaald worden).
+
+### Indienstatus
+
+Je **indienstatus** voor een oefening uit een oefeningenreeks wordt bepaald op basis van de oplossing die je als laatste in de cursus hebt ingediend voor de oefening. Als er een deadline werd ingesteld voor de oefeningenreeks, dan is dit de laatst ingediende oplossing voorafgaand aan de deadline. In de oefeningenreeks zie je vóór elke oefening ook een **icoontje** dat correspondeert met je indienstatus voor de oefening. Als je in een oefeningenreeks drukt op je indienstatus voor een oefening, dan navigeer je naar de oplossing die gebruikt werd om de indienstatus te bepalen (als je effectief een oplossing hebt ingediend op basis waarvan de indienstatus kon bepaald worden).
+
+Mogelijke weergaven van je indienstatus vóór het verstrijken van de deadline of als er geen deadline is ingesteld:
+
+  | indienstatus | icoontje | weergegeven als je |
+  | --- | --- | --- |
+  | `niet opgelost` | | geen oplossing hebt ingediend (vóór de deadline) | 
+  | `verkeerd` | ![image](../../../../images/course_exercise_status_icons/wrong.png) | laatste oplossing die je indiende verkeerd was |
+  | `correct` | ![image](../../../../images/course_exercise_status_icons/before_deadline.png) |laatste oplossing die je indiende correct was (vóór de deadline) |
+
+Mogelijke weergaven van je indienstatus nadat de deadline verstreken is:
+
+  |indienstatus | icoontje | weergegeven als je |
+  |-------------|----------|--------------------|
+  | `correct` (groen) | ![image](../../../../images/course_exercise_status_icons/before_deadline.png) | laatst ingediende oplossing vóór de deadline correct is|
+  | `deadline gemist` (rood) | ![image](../../../../images/course_exercise_status_icons/after_deadline.png) | geen oplossingen hebt ingediend|
+  | `deadline gemist` (rood) | ![image](../../../../images/course_exercise_status_icons/after_deadline.png) | als je laatst ingediende oplossing niet correct is |
+  | `deadline gemist` (rood) | ![image](../../../../images/course_exercise_status_icons/after_deadline.png) | als je na de deadline een correcte oplossing hebt ingediend |
+
+::: tip Belangrijk
+
+Als je **vóór het verstrijken van de deadline** van een oefeningenreeks een oplossing indient voor een oefening uit de oefeningenreeks, dan kan je indienstatus voor de oefening nog wijzigen omdat die indienstatus altijd gebaseerd is op je laatst ingediende oplossing vóór de deadline. Het is dus je eigen verantwoordelijkheid om ervoor te zorgen dat je laatst ingediende oplossing vóór de deadline ook je meest correcte oplossing is. Je kunt eventueel een voorgaande oplossing selecteren en opnieuw indienen.
+
+Dodona toont een **waarschuwingssymbool** naast je indienstatus van een oefening in een oefeningenreeks en in de lijst met recente op je startpagina als je laatst ingediende oplossing voor de oefening vóór de deadline van de oefeningenreeks een status heeft die slechter is dan de status van een oplossing voor de oefening die je daarvoor hebt ingediend. Je kunt eventueel een voorgaande oplossing selecteren en opnieuw indienen.
+
+![image](./student.deadline_series_warning.png)
+
+Als je **na het verstrijken van de deadline** van een oefeningenreeks een oplossing indient voor een oefening uit een oefeningenreeks, dan zal je indienstatus voor de oefening in de oefeningenreeks daardoor nooit wijzigen. Je indienstatus voor een oefening in een oefeningenreeks wordt immers bepaald op basis van je laatst ingediende oplossing vóór de deadline.
+:::
+
+
+## Uitschrijven uit een cursus
+
+Als je navigeert naar een cursus waarvoor je [geregistreerd](#registreren-voor-een-cursus) bent of waarvoor je nog een registratieverzoek hebt openstaan, dan zie je onder de beschrijving van de cursus op de cursuspagina een knop `UITSCHRIJVEN` waarmee je je kunt uitschrijven uit de cursus.
+
+![image](./student.unregister.png)
+
+Hierdoor verdwijnt het kaartje van de cursus aan de linkerkant van je startpagina en wordt de cursus niet langer opgelijst op je [profielpagina](../login-and-settings/#instellen-van-persoonlijke-voorkeuren). Als de cursus werd opgelijst onder `Mijn vakken` in het hamburger menu aan de linker kant van de navigatiebalk, dan verdwijnt de cursus ook uit die lijst. Als de cursus werd opgelijst in het paneel `Wachten op goedkeuring` in de rechterkolom van je startpagina, dan verdwijnt de cursus ook uit die lijst.