Skip to content

Teacher docs #73

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 63 commits into from
Sep 5, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
63 commits
Select commit Hold shift + click to select a range
d5e96b3
First part of user management
winniederidder Aug 12, 2020
63118e9
Finish dutch version
winniederidder Aug 12, 2020
67eeb1f
Start on English version of user management
winniederidder Aug 12, 2020
035453c
Another big chunk of English docs
winniederidder Aug 12, 2020
4a25e60
Another part
winniederidder Aug 12, 2020
74e284d
Finish English version
winniederidder Aug 13, 2020
2a4f760
Apply some suggested fixes
winniederidder Aug 13, 2020
8c77303
Rewrite and redo images
winniederidder Aug 14, 2020
3fe38e6
Delete impersonating docs
winniederidder Aug 14, 2020
a4a5e66
Big chunk of course management
winniederidder Aug 14, 2020
93a2d9c
More course docs
winniederidder Aug 14, 2020
48dd570
Add last English part, only Dutch from now on
winniederidder Aug 14, 2020
45fd830
Big chunk
winniederidder Aug 17, 2020
fc5fcd1
Finish links
winniederidder Aug 17, 2020
ef12258
Fixes
winniederidder Aug 19, 2020
23d2794
Apply some suggestions to user management
winniederidder Aug 20, 2020
f7692eb
Start series management
winniederidder Aug 20, 2020
2ac284a
More series management
winniederidder Aug 21, 2020
2ee8fe9
Large updateé
winniederidder Aug 21, 2020
3c924de
Add series evaluation
winniederidder Aug 24, 2020
ca617c4
Update series export
winniederidder Aug 24, 2020
1dbad01
Displays, but not fully compiling
winniederidder Aug 26, 2020
c528349
Fix image links
winniederidder Aug 26, 2020
a6bf51a
Add last images
winniederidder Aug 27, 2020
4ea364e
Fixes to series management
winniederidder Aug 27, 2020
8f7a747
Resolved sidebar issue
winniederidder Aug 27, 2020
9a31a92
Sidebar fixes in course management
winniederidder Aug 27, 2020
e7d1273
User management pictures
winniederidder Aug 27, 2020
341ab59
Fix todo image
winniederidder Aug 28, 2020
064b43b
Replace guilabel with backticks
winniederidder Aug 28, 2020
9a2fe5e
Add titels
winniederidder Aug 28, 2020
4e47f7e
Remove bolds
winniederidder Aug 28, 2020
ad0b3fd
Add permission picture
winniederidder Aug 28, 2020
e68725f
Remove redundant part
winniederidder Aug 28, 2020
26e8a41
Add another picture, fix some remarks already
winniederidder Aug 31, 2020
d7d8d4c
Fix most remarks
winniederidder Aug 31, 2020
7b3bbe1
Start on series exercises
winniederidder Aug 31, 2020
257351f
More updates to exercise-series-management
winniederidder Sep 1, 2020
96d570f
Update user management
winniederidder Sep 1, 2020
1b0715c
Fix some links
winniederidder Sep 1, 2020
7dffa5f
More links
winniederidder Sep 1, 2020
1a50f7a
Make links relative
winniederidder Sep 1, 2020
4771192
Maybe url fix?
winniederidder Sep 1, 2020
90397c0
Typo fix
winniederidder Sep 1, 2020
4be2dc0
Add new-course guide
winniederidder Sep 1, 2020
1546f27
Fix indents
winniederidder Sep 1, 2020
3cf276b
Suggested changes to course management
winniederidder Sep 2, 2020
05ce6d8
druk -> klik and more
winniederidder Sep 2, 2020
6bad9ef
Resolve new course remarks
winniederidder Sep 2, 2020
00d56b5
Resolve user management remarks
winniederidder Sep 2, 2020
c3fde80
Minor fixes
winniederidder Sep 2, 2020
1afff1e
Remove redundant part
winniederidder Sep 2, 2020
4b45b72
Resolve exercise series remarks
winniederidder Sep 3, 2020
eea2cd7
Resolve last
winniederidder Sep 3, 2020
c214b93
Rename, add ''english'' and move pictures
winniederidder Sep 3, 2020
611bdb8
Cleanup en course management pictures
winniederidder Sep 3, 2020
707fd92
user management english pictures
winniederidder Sep 3, 2020
0fe5989
Migrate exercise series pictures
winniederidder Sep 3, 2020
5f7e6e3
Delete staff.hidden_course_registration_link.png
winniederidder Sep 4, 2020
a7223c0
update course management
bmesuere Sep 5, 2020
d1b0f55
update user management
bmesuere Sep 5, 2020
ffe1e11
update create a course
bmesuere Sep 5, 2020
d8c3a5a
update series management
bmesuere Sep 5, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -157,6 +157,10 @@ function getGuidesSidebar(lang, groupTitle, FirstItem, studentGuideItem) {
]
},
'getting-started/',
'creating-a-course/',
'course-management/',
'user-management/',
'exercise-series-management/',
'pycharm-plugin/',
'vs-code-extension/',
'new-exercise-repo/',
Expand Down
4 changes: 4 additions & 0 deletions en/guides/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,3 +17,7 @@ Here you'll find a number of guides, primarily focused on teachers.
## Only in Dutch
* [Van start met Dodona als student](for-students)
* [Van start met Dodona als leerkracht](getting-started)
* [Een nieuwe cursus aanmaken](creating-a-course)
* [Cursusbeheer](course-management)
* [Gebruikersbeheer](user-management)
* [Oefeningenreeksenbeheer](exercise-series-management)
63 changes: 63 additions & 0 deletions en/guides/course-management/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: "[nl] Cursusbeheer"
description: "Tutorial: cursusbeheer"
---

::: warning Sorry
For now, this page is only available in Dutch. Sorry!
:::

# Cursusbeheer
> Op deze pagina vind je alle informatie over cursusbeheer op Dodona.

**Inhoudsopgave**
[[toc]]

Een cursus wordt opgebouwd als een leerpad met oefeningen die gebundeld worden in oefeningenreeksen. De opeenvolging van oefeningenreeksen impliceert een mogelijke volgorde waarin de oefeningen kunnen opgelost worden. Gebruikers kunnen zichzelf registreren voor een cursus. Er is altijd minstens één gebruiker die cursusbeheerder is, bijvoorbeeld de gebruiker die de cursus aanmaakte. Voor informatie over hoe je een nieuwe cursus aanmaakt, kan je [hier](../creating-a-course) terecht.

## Beheersrechten

Cursusbeheerders hebben binnen een cursus speciale rechten. Ze kunnen de cursus aanpassen naar hun wens en de voortgang van de studenten die voor de cursus zijn ingeschreven opvolgen. De gebruiker die de cursus aanmaakt wordt standaard aangesteld tot cursusbeheerder. Hij kan op zijn beurt andere extra cursusbeheerder aanstellen onder de gebruikers die voor de cursus zijn ingeschreven.

## Cursus bewerken

Om de eigenschappen van een bestaande cursus te bewerken, navigeer je naar de cursuspagina en klik je op het bewerken-icoontje bovenaan.

![cursus bewerken knop](./staff.course_edit_button.png)

Je komt op een pagina terecht waar je de naam, lesgevers, beschrijving, academiejaar, zichtbaarheid en registratieprocedure kan aanpassen. Voor meer details over de specifieke eigenschappen kan je terecht op [deze pagina](../creating-a-course/#cursuseigenschappen).

Klik na het aanpassen op de afwerkknop in de rechterbovenhoek van het paneel om de nieuwe cursuseigenschappen op te slaan. Alternatief kan je ook op de `AANPASSEN` klikken onderaan het paneel. Daarna navigeer je automatisch terug naar de cursuspagina waar de nieuwe cursuseigenschappen onmiddellijk van toepassing zijn.

![image](./staff.course_after_edit.png)

## Een cursus opbouwen

Als cursusbeheerder kan je voor de cursus een leerpad uitstippelen. Het leerpad wordt op de cursuspagina weergegeven onder de hoofding `Oefeningenreeksen`. Aan het leerpad kan je oefeningenreeksen toevoegen waaraan je oefeningen kunt koppelen. Voor meer uitleg over wat je allemaal kan doen, zie [oefeningenreeksen beheren](../exercise-series-management).

## Cursusgebruikers beheren

Om een overzicht te krijgen van de gebruikers in een cursus, klik je op het gebruikersicoontje in de navigatiebalk bovenaan de cursuspagina. Voor meer informatie over welke acties je daar kan uitvoeren, kan je de handleiding over [gebruikersbeheer](../user-management) raadplegen.

## Navigeren naar oplossingen

Als cursusbeheerder kan je alles opvolgen wat binnen je cursus gebeurt. Om een overzicht te krijgen van alle oplossingen die door de studenten werden ingediend klik je op `Ingediende oplossingen` bovenaan de cursuspagina of op het icoontje in de navigatiebalk.
![cursus oplossingen link](./staff.course_submissions_link.png)

Het overzicht bevat heel wat informatie per inzending, zoals de naam van de gebruiker en de naam van de oefening, inclusief filters voor deze waarden. Ook de status, het tijdstip en een link naar de inzending zijn aanwezig.
![filter submissions](./staff.course_submissions_filter.png)

Als je klikt op het filter-icoontje voor de naam van een student of oefening, dan zal de lijst inzendingen gefilterd worden en enkel oplossingen tonen voor die specifieke gebruiker of oefening.

![filtered submissions](./staff.course_submissions_filtered.png)

Deze oplossingen kan je ook op andere manieren bereiken:

* Een overzicht van de oplossingen voor een **specifieke oefening** vind je door op de cursuspagina op het pijltje rechts van een oefening te klikken.
* Een overzicht van de oplossingen voor **specifieke gebruiker** vind je door op `OPLOSSINGEN` te klikken op de [cursuspagina van die gebruiker](../user-management/#studenten-opvolgen).

In het oplossingenoverzicht vindt je rechts van de filterbalk een knop met 3 puntjes. In het menu vindt je enkele acties en filter:

* `Meest recente correcte oplossing per gebruiker`: Beperkt het overzicht tot de meest recente correcte oplossing per gebruiker.

* `Oplossingen hertesten` (actie): [Hertest](../exercise-series-management/#oplossing-hertesten) alle oplossingen uit het overzicht.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
81 changes: 81 additions & 0 deletions en/guides/creating-a-course/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
---
title: "[nl] Een nieuwe cursus aanmaken"
description: "Tutorial: cursus aanmaken"
---

::: warning Sorry
For now, this page is only available in Dutch. Sorry!
:::

# Een cursus aanmaken

:::tip Belangrijk

Je hebt extra rechten nodig om een cursus te kunnen aanmaken. Contacteer ons op [[email protected]](mailto:[email protected]) of via het [contactformulier](https://dodona.ugent.be/nl/contact) en we geven je account zo snel mogelijk de nodige toegangsrechten.

:::

Als je de nodige rechten hebt op Dodona, dan kan je eenvoudig zelf een cursus aanmaken. Dit doe je door op de knop `CURSUS AANMAKEN` te klikken in de rechterbovenhoek van het [cursusoverzicht](https://dodona.ugent.be/nl/courses). Vanaf de landingspagina bereik je dit overzicht door te klikken op `Meer cursussen`.

![create course](./staff.courses_new_link.png)

Om een nieuwe cursus aan te maken, zijn er twee opties. Ofwel vertrek je vanaf een reeds bestaande cursus en kopieer je de inhoud, ofwel maak je een volledige nieuwe cursus aan. Klik op een van de twee knoppen om je keuze te maken. Als je er voor kiest om met een lege cursus te beginnen kan je direct naar de [sectie over cursuseigenschappen](#cursuseigenschappen) gaan

![new course menu](./staff.course_new_options.png)

## Cursus kopiëren

Als je gekozen hebt om een bestaande cursus te kopiëren, dan krijg je een lijst van alle zichtbare cursussen op Dodona te zien. Via de zoekbalk kan je filteren om snel de gewenste cursus te vinden. Via de link-knop aan de rechterkant van de tabel open je de betreffende cursus in een nieuwe venster. Zo kan je snel controleren of dit de juiste cursus is. Klik het bolletje in de linkerkolom aan om je keuze te bevestigen.

![choose existing course](./staff.course_new_copy_course_options.png)

Vervolgens moet je aangeven welke elementen van de cursus je wil overnemen. De reeksstructuur inclusief beschrijvingen worden altijd gekopieerd. Je kan dan nog kiezen of je de oefeningen, de deadlines en de cursusbeheerders wil overnemen. Vervolgens kan je er ook voor kiezen om de gekopiëerde reeksen standaard allemaal op verborgen te zetten. Dit is zeer handig als je nog niet de volledige cursus wil vrijgeven aan je studenten.

![choose existing course extra](./staff.course_new_copy.png)

## Cursuseigenschappen

Finaal moet je nog enkele zaken over de cursus zelf, zoals de naam en lesgever, instellen. Deze worden vooraf ingevuld met de waarden van de gekopieerde cursus indien deze optie gekozen werd. Volgende eigenschappen kunnen ingesteld worden.

![image](./staff.course_new_empty.png)

* `Naam`: een naam voor de cursus. Verschillende curssen kunnen dezelfde naam hebben, maar het is echter aangeraden om cursussen zoveel mogelijk een unieke naam te geven.

* `Lesgevers`: de name of namen van de lesgevers van de cursus.

* `Academiejaar`: het academiejaar waarin de cursus wordt aangeboden. Gebruik het formaat `jjjj-jjjj` om ervoor te zorgen dat de cursus correct gesorteerd wordt op de startpagina en in het cursusoverzicht.

* `Zichtbaarheid`: dit bepaalt of niet-geregistreerde gebruikers de cursus kunnen zien. Voor deze eigenschap kunnen de volgende waarden ingesteld worden:

* `Zichtbaar`: alle gebruikers zien de cursus in het cursusoverzicht. Ze kunnen ook naar de cursuspagina navigeren en zich daar eventueel voor de cursus registreren.

* `Verborgen`: alleen cursusbeheerders zien de cursus in het cursusoverzicht en op hun startpagina. Er staat een icoontje bij om hen er op te wijzen dat andere gebruikers de cursus daar niet kunnen zien. Dit icoontje is ook te vinden op de cursuspagina zelf. Enkel geregistreerde gebruikers kunnen naar deze pagina navigeren. Andere gebruikers kunnen zich enkel voor de cursus registreren als ze een rechtstreekse registratielink gebruiken.

![verborgen cursus](./staff.course_hidden.png)

* `Registratieprocedure`: deze eigenschap bepaalt of en hoe gebruikers zich voor de cursus kunnen registreren. Voor deze eigenschap kunnen de volgende waarden ingesteld worden:

* `Open`: gebruikers kunnen zich vrij voor de cursus registreren zonder expliciete goedkeuring van een cursusbeheerder.

* `Gemodereerd`: gebruikers kunnen een registratieverzoek indienen voor de cursus maar zijn pas geregistreerd als een cursusbeheerder hun registratieverzoek heeft goedgekeurd.

* `Gesloten`: gebruikers kunnen zich niet zelf voor de cursus registreren.

::: tip Belangrijk

Als je de registratieprocedure aanpast, dan blijven bestaande registraties voor de cursus gelden en blijven registratieverzoeken voor de cursus openstaan. Je moet zelf de bestaande registratiestatus van cursusgebruikers aanpassen.
:::

* `Beschrijving`: optioneel stuk dat bovenaan de cursuspagina wordt weergegeven. Voor het opmaken van de beschrijving kan je gebruikmaken van [Markdown](https://en.wikipedia.org/wiki/Markdown). Dodona maakt voor de weergave van Markdown gebruik van [kramdown](https://kramdown.gettalong.org) waardoor heel wat uitbreidingen van de standaard Markdown ondersteund worden. Voor meer uitleg over hoe deze formattering werkt, kan je [hier](/nl/references/exercise-description/) terecht.

* `Registratielink`: bij het aanmaken van een cursus wordt automatisch een registratielink gegenereerd als afschermingsmechanisme van verborgen cursussen. Zonder deze link kunnen niet-geregistreerde gebruikers de cursuspagina van een verborgen cursus niet zien en zich daar dus ook niet registreren. Je vindt deze registratielink op de cursus-bewerkenpagina. Klik op de kopieerknop naast de registratielink om de registratielink naar het klembord te kopiëren.

![registratielink](./staff.course_hidden_registration_link.png)

De registratielink heeft dus als voordeel dat gebruikers de cursus niet zelf moeten zoeken in het cursusoverzicht en dat ze meteen een verzoek krijgen om zich voor de cursus te registreren als ze dat nog niet gedaan hadden. Als cursusbeheerder krijg je de verantwoordelijkheid om de registratielink enkel te delen met niet-geregistreerde gebruikers die zich voor een verborgen cursus mogen registreren.

Eenmaal alles naar wens is ingesteld klik je op de knop `CURSUS AANMAKEN` om je cursus definitief aan te maken.

Na het aanmaken van de nieuwe cursus navigeer je automatisch naar de cursuspagina, waar je kunt vaststellen dat je automatisch geregistreerd bent als cursusgebruiker en dat je aangeduid bent als cursusbeheerder.

![cursus aangemaakt](./staff.course_created.png)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading