Verantwoordingsdocument Tips
Inhoud
v0.1.0 Start document voor verantwoordingsdocument tips door HU IICT.
Een aantal tips voor het schrijven van een goed en leesbaar verantwoordingsdocument.
Verantwoordingsdocument
- Maak gebruik van het template
- Vul alleen aan of vervang placeholder tekst dat staat tussen code blocks of span of code.
- Gebruik de Visual Studio Code Markdown PDF plugin om van jouw Markdown-bestand een PDF te genereren.
- Upload alleen dat PDF bestand bij de inlevering op Canvas.
- Het is een levend document. Na het peilmoment kan je weer verder werken aan je Verantwoordingsdocument. Een bijgewerkte versie lever je in op een volgend peilmoment.
Portfolio en Portfolio-Items
- Met een portfolio laat je zien wat je hebt geleerd en hoe je deze kennis hebt toegepast. Een foto of video kan een onderdeel van een portfolio item zijn, maar een link naar een foto alleen is niet voldoende. Je moet kunnen aantonen dat het opgegeven portfolio item ook voldoet aan de opgestelde (minimale) criteria. Ook dien je feedback te hebben opgehaald en verwerkt.
- Een portfolio-item kan gebruikt worden om meerdere leeruitkomsten te ondersteunen. Er zijn meerdere verschillende portfolio-items vereist om de meeste leeruitkomsten goed te kunnen onderbouwen.
- In jouw GitHub-repository gebruik je Markdown (.md) voor het documenteren van je werk. Deze bestanden zijn in GitHub meteen te zien. Een PDF of Word document gaan wij niet downloaden en bekijken.
- Een portfolio-item is altijd herleidbaar naar een document op je persoonlijke repository.
- Verwijs niet naar Google docs of andere documenten op locaties die na afloop niet meer beschikbaar voor ons zijn. Je persoonlijke repo blijft wel beschikbaar en gaat aan het eind van het semester ‘op slot’ en is dan alleen nog te raadplegen.
Structuur van jouw repositories
- Zorg voor een overzichtelijke structuur in je persoonlijke- en groeps-repository.
- Maak in elke directory een README.md aan met uitleg wat er gevonden kan worden.
- Commit regelmatig en geef betekenisvolle commit-berichten (mag in het Engels)