Research and Development 1/2012-13/instructies/Fase 3/eindverslag

Product

Eindverslag

Inleiding

In het eindverslag documenteren jullie de app zoals die uiteindelijk geworden is. Jullie laten van enkele ontwerpbeslissingen zien hoe ze genomen zijn. Verder reflecteren jullie op de werkwijze.

Instructie

1. Kies een aansprekende titel. Dus niet ‘Verslag R&D1’ of iets dergelijks.
2. Werk het verslag uit aan de hand van de volgende indeling. Het verslag wordt geproduceerd met LaTeX.
   • Voorwoord

   Geef aan waarvoor het document bedoeld is en in het kader waarvan het geschreven is. Beschrijf hoe het document is opgebouwd (leeswijzer).

   • Beschrijving

   • Inleiding

   Globale beschrijving van het product en belangrijkste eigenschappen. Dit kan geïllustreerd worden aan de hand van (screenshots van) het userinterface.

   • Productverantwoording

   Hierin geef je aan waarom het bouwen van deze app de moeite waard was. Je zult waarschijnlijk gebruik kunnen maken van de argumentatie uit het ontwerpdocument, eventueel na aanpassing of aanvulling.

   • Specificaties

   Beschrijving van de eigenschappen van de applicatie. (Her)gebruik de specificaties in het ontwerpdocument. Pas ze zo nodig aan zodat ze het uiteindelijke product karakteriseren. Je hoeft niet alles over te doen: beschrijf de functionele eigenschappen in een use case model, en de niet-functionele eigenschappen in een opsomming. Werk bovendien één interessante use case volledig uit.

   • Ontwerp

   • Globaal ontwerp

   Geef het globale ontwerp. Hergebruik zoveel mogelijk de beschrijving in het ontwerpdocument!

   Beschrijving van de opbouw van het systeem. Geef een functionele opsplitsing in componenten die overeenkomt met de wijze waarop jullie het systeem hebben gebouwd. Licht de samenhang toe.

   • Detailontwerp

   Geef het detail-ontwerp in termen van klassen, methoden en attributen, beperkt tot de use case die je hebt uitgewerkt.

   • Ontwerpverantwoording

   Geef aan waarom jullie ontwerp een goed ontwerp is. Werk twee interessante ontwerpbeslissingen en/of technische details uit. Geef bijvoorbeeld mogelijke alternatieven en afwegingen, of beschrijf een onderzoekje of experiment. De verantwoording kun je theoretisch (vanuit bekende methoden, literatuur) aanpakken, maar ook empirisch (experimenteel).

   Tijdens de eerste workshop over documenteren en verantwoorden hebben we besproken hoe zo'n verantwoording eruit kan zien.

   • Reflectie

   Geef aan waarover jullie tevreden zijn. Beschrijf ook waarover jullie minder tevreden zijn. Het gaat om concrete: bereikte resultaten, dingen die jullie geleerd hebben, opgeloste (technische) problemen etc. Werk een positieve en een negatieve ervaring uit. Beschrijf en analyseer de bepalende factoren en trek een conclusie. Welke gevolgen heeft dat voor toekomstig werk: hoe zouden jullie het een volgende keer aanpakken?

   Gebruik de opbrengst van de tweede workshop over documenteren en verantwoorden.

Werkplaats

Voor het eindverslag maak je een subpagina van de projectpagina. Gebruik het volgende stukje code als basis en zet op deze pagina een link naar het PDF-bestand dat je met LaTeX hebt gemaakt.

{{RD1-eindverslag
|Projectgroep=groepsnaam
|Auteurs=auteur1, auteur2, auteur3
|Onderwerp=nog in te vullen
}}
[[Academisch jaar::2012-13| ]]

Beoordeling

Via onderstaande rubric met kwaliteitskenmerken.

Taalgebruik: bij meer dan 10 fouten wordt het verslag niet beoordeeld. Organiseer zonodig taaladvies.

BESCHRIJVING	1 ondeugdelijk	2 matig	3 adequaat	4 excellent
Productbeschrijving	summier	vaag, laat veel aan voorstellingsvermogen van de lezer over	informatief over vorm en gedrag, met weinig moeite voorstelbaar	geeft een compleet beeld
Productverantwoording	geen verwijzingen naar verwante producten en succesfactoren	vergelijking met verwante producten en succesfactoren, maar eigen indruk staat voorop	bevat zorgvuldige redenering gebaseerd op vergelijking met enkele verwante producten en succesfactoren	overtuigend; geeft een compleet beeld van de waarde van de app ten opzichte van bestaande producten en succesfactoren
Specificaties – inhoud	vergezocht of obligaat	zinvolle eigenschappen, maar niet volledig: essentiële aspecten ontbreken	zinvolle eigenschappen, volledig op enkele details na	zinvol, volledig
– formulering	vaag, ambigu	vaag maar (met enige moeite) interpreteerbaar	specifiek, met weinig moeite aan te vullen tot testbare eigenschappen	consequent volledig SMART: direct over te nemen als testdoelen in gebruikerstest
– use case	ontbreekt of summier	obligaat of essentiële onderdelen ontbreken	zinvol gekozen, volledig op enkele details na	zinvol gekozen, volledig
Opmerkingen

ONTWERP	1 ondeugdelijk	2 matig	3 adequaat	4 excellent
Globaal ontwerp	reduceert complexiteit niet	onhandige opsplitsing	zinvolle, weldoordachte modularisering, niet helemaal volledig	zinvolle, weldoordachte modularisering
Detailontwerp	niet in termen van klassen, attributen, methoden	in de juiste termen, maar niet volledig tov gekozen use case	volledig tov use case, essentiële klassen en methoden genoemd	volledig tov use case, uitgebreid met voorziene systeemspecifieke onderdelen
Ontwerpverantwoording – gekozen aspecten	vergezocht of triviaal	zinvol maar secundair	zinvol, belangrijk voor werking en/of ontwikkeling van de app	vakinhoudelijk interessant, reikt verder dan deze enkele app
– uitgangspunten	geheel gebaseerd op eigen indrukken of opinies	eigen indrukken staan voorop, verbonden met aspecten van eigen ontwikkelproces	vanuit expliciete criteria met behulp van externe bronnen of experimenten	idem, waarbij de criteria zelf verantwoord zijn via objectieve redenering of literatuur
– redenering	kort door de bocht	redenering met grote hiaten	nagenoeg volledige en correcte redenering	volledige en correcte redenering
Opmerkingen

REFLECTIE	1 ondeugdelijk	2 matig	3 adequaat	4 excellent
Positieve en negatieve aspecten	obligaat	enkele zinvolle aspecten	meerdere (elk ≥3) zinvolle aspecten	rijke beschouwing, breed
Analyse	mager	factoren gekarakteriseerd maar niet gestructureerd	systematisch, zinvol gestructureerd	diep, interessante grote lijnen, verbanden gesignaleerd
Conclusie	conclusie, vervolgpunten mager of afwezig	conclusie geformuleerd	conclusie geformuleerd, met enige moeite te vertalen naar actiepunten voor toekomst	conclusie geformuleerd, incl. concrete actiepunten voor toekomstig werk
Opmerkingen

ALGEMEEN	1 ondeugdelijk	2 matig	3 adequaat	4 excellent
Taalgebruik	slordig	correct, maar niet passend bij het genre ontwerp/onderzoeksverslag	passend bij genre, hier en daar een kleine ontsporing	perfect
Leesbaarheid	mager	toelichting minimaal	hier en daar ontbreekt sturing of toelichting, maar het verhaal is te volgen	sturing, toelichting aanwezig waar nodig, verhaal leest vloeiend
Verzorgdheid	rommelig	basic, documentindeling LaTeX in orde	idem, plus vormgeving bijzondere onderdelen (tabellen, plaatjes, diagrammen) goed ingepast in LaTeX	fraai, zorgvuldig, LaTeX optimaal benut, alle details goed afgewerkt
Opmerkingen

Tips

• Bij alles hoort een uitleg (bijvoorbeeld: waarom is de gekozen use case interessant?)
• Sturing van de lezer: val niet met de deur in huis, spring niet van de hak op de tak. Voer de lezer (‘aan de hand’) door het document heen.
• Formulering: houd het zakelijk en to-the-point.