Logboek

Zie ook template van de groepsrepo op GitHub.

In de eerste week zet je je logboek op (zie ook de template GitHub). Doel ervan is dat docenten inzicht krijgen in jouw individuele bijdragen en het groepsproces, en ook als ze niet in de groep aanwezig zijn zicht hebben op hoe het jou vergaat. Het logboek moet aan het eind van iedere dag up-to-date zijn.

In het logboek staat per dag aangegeven waar je aan gewerkt hebt, en per item geef je aan:

• Hoe lang ben je ermee bezig geweest?
• Geef een directe link naar de taak waar je aan hebt gewerkt
  • Zorg dat je linkt naar specifieke taken onder de hoofdtaak (spike, walking skeleton, documentatie)
• Met wie heb je eraan gewerkt?
• Een korte evaluatie van het resultaat waarin je aangeeft:
  • Kwam er eruit wat je hoopte of verwachtte? Noem daarbij een paar interessante en of opvallende inhoudelijke details.
  • Duurde het langer (of korter) dan je verwachtte? Met name dat laatste is van belang als je in timeboxes werkt aan spikes.
• Hoe vond je het om aan deze taak te werken?
  • Leuk/interessant- Gewoon- Saai-Frustrerend? Je mag dit in woorden of met smileys aangeven.
  • Hoe trots ben je op het resultaat? Zeer-Neutraal-Helemaal niet. Je mag dit in woorden of met smileys aangeven.
• Als laatste eventueel een directe link naar het resultaat van je activiteiten (bijvoorbeeld reflectieverslag, reviewcommentaar, notulen)
  • Dit is een veld/kolom in je logboek voor wanneer de link naar de taak het resultaat dat jij hebt geleverd niet helder maakt

tip

Wees concreet in de evaluatie van het resultaat

• In plaats van "We hadden onze eerste DSU gedaan. Het ging goed." kun je schrijven "We hadden onze eerste DSU gedaan. Het ging goed omdat we een goed overzicht hadden van onze voortgang en er zeker van zijn dat alle werkzaamheden voor deze periode af komen."

• In plaats van "We hebben onszelf voorgesteld en onze leerdoelen besproken." neem je ook een link op naar de beschrijving van die leerdoelen.

• In plaats van "Samen waren we met iedereen door het gehele PvA gegaan en hebben we alles verbeterd of nog toevoegingen gedaan." voeg je de beide commits toe: de ene met oude versie van het PvA, de andere met de nieuwe versie.

• In plaats van "Dieper inzicht verkregen in de werking van het project." kun je schrijven "Nu het project werkt heb ik gezien welke projectstructuur is gekozen, hoe alle assets zijn ingedeeld en waar ik zou beginnen met het migreren naar een ander platform."

• In plaats van "Ik heb mijn team ook betrokken door ze te vragen naar projectgrenzen die mij vaag leken." kun je schrijven "Ik heb mijn team ook betrokken door ze te vragen naar projectgrenzen die mij vaag leken, hierdoor konden we projectgrens 2 verbeteren door concrete start- en einddata toe te voegen."

tip

Maak de status van de taak duidelijk in de evaluatie

• In plaats van "Ik ging werken aan hoofdstuk 8 van het PvA." kun je beter schrijven "Ik ging werken aan hoofdstuk 8 van het PvA, hiervoor was 2 uur tijd beschikbaar en na 1 uur had ik de werkafspraken vastgelegd en is er nog 1 uur over voor het beschrijven van de rollen, dat is onvoldoende om alles af te krijgen".

• In plaats van "Ik ben begonnen met hoofdstuk zes na vier en het maken van SMART doelen bij de verschillende producten ging moeizaam. Ik ga het morgen afmaken." kun je schrijven "Ik ben begonnen met hoofdstuk zes na vier en het maken van SMART doelen bij de verschillende producten ging moeizaam. Ik heb 60 van de 90 beschikbare minuten gebruikt en maak morgen in de resterende 30 minuten deze taak af. Het ging moeizaam omdat ik me moeilijker kon concentreren gedurende het laatste werkuur.".

tip

Maak het verloop van de taak concreet in de evaluatie

• In plaats van "Ik heb het hoofdstuk "Projectgrenzen" gemaakt. Het ging best soepel." kun je schrijven "Ik heb het hoofdstuk "Projectgrenzen" gemaakt, dit ging binnen de geplande tijd en uit de review kwamen geen verbetersuggesties".

• In plaats van "Ik heb mijn wijzigingen overlegd en uitgelegd aan de desbetreffende teamgenoot. Ik ben zeer tevreden met de verbeteringen die ik heb kunnen maken." kun je schrijven "Ik heb mijn wijzigingen overlegd en uitgelegd aan de desbetreffende teamgenoot. Ik ben zeer tevreden met de verbeteringen die ik heb kunnen maken omdat in de vorige versie twee onjuistheden en één tegenstrijdigheid zat."

tip

Geef docenten inzicht in waar jouw uitdagingen liggen door aan te geven hoe je het vond om aan deze taak te werken

• In plaats van "Basis documentatie geschreven maar het schrijfwerk was niet erg uitdagend." kun je schrijven "Basis documentatie geschreven maar het schrijfwerk was niet erg uitdagend omdat ik sneller dan andere studenten schrijf en een technische voorsprong heb. Ik ga morgen een andere taak oppakken die net buiten mijn comfortzone ligt zoals het programmeren van een prototype in een voor mij volledig onbekende taal en onbekend platform."

tip

Geef docenten concreet inzicht in interessante tussenstappen en resultaten

• Het vastleggen van tussenstappen met een directe link vanuit je logboek of het regelmatig committen van resultaten naar de repository geeft een beeld van de voortgang van jouw activiteiten
• Zorg dat je bij het committen naar de groepsrepo in het bericht de hoofdtaak vermeld.

Voor gelinkte commits naar een hoofdtaak is de link naar resultaten overbodig, want het resultaat is te traceren via de taak.

Bijvoorbeeld

• een spike met nummer 21 heeft een taak met nummer 31 in github project
• bij de commit geef je een commit message
  • "Prototype ontwikkeld om mongodb voor opslag te testen #21"
• in het logboek geef je een link naar de taak in github projects
  • https://github.com/AIM-ENE/test-project/issues/31

Hiermee krijg je een mooie traceability van logboek naar taak (31) naar spike (21) naar commit (x) naar veranderingen in bestanden.