Voorbereiding eindpresentatie

Bereid samen een presentatie voor waarin jullie de tweede versie van jullie Software Guidebook presenteren. De presentatie duurt maximaal 10 minuten, daarna is er 10 minuten tijd voor vragen aan/van de docenten en een parallelgroepje. In de presentatie komen de volgende onderdelen aan bod:

• De aanpassingen aan context en container diagrammen n.a.v. de feedback van de vorige presentatie.
• Component diagrammen
  • Statische en dynamische diagrammen
  • Dynamische diagrammen op basis van de twee scenario's voor het walking skeleton
  • Ontwerpidee op basis van de gekozen design patterns zoveel mogelijk geintegreerd
  • Laat de geïntegreerde versie zien met toelichting en laat zien hoe je vanuit de individuele versies tot deze gezamenlijke diagrammen bent gekomen.
• De design patterns waar jullie een prototypes voor gaan maken in week 3:
  • Noem de naam van dit pattern
  • Leg uit welke quality attributes en welke principes relevant zijn en leg uit welk probleem dit pattern oplost.
• Een overzicht van leervragen opgekomen tijdens deze week, met hierbij aangegeven:
  • de leervragen waar je dit project waarschijnlijk GEEN antwoord op gaat krijgen.
  • de leervragen waar je wel antwoord op wil/nodig hebt maak je (nieuwe) spikes aan op je GitHub issue bord (met in het issue die concrete leer-/onderzoeksvraag) ^*
• De werkverdeling/planning voor week 3
  • uitgedrukt in (nieuwe) spikes met bijbehorende taken
  • walking skeleton issue uitgebreid met taken voor integratie individueel werk

Tijdens de presentatie maak je gestructureerd aantekeningen die je mogelijk uitbreidt met informatie die het groepje voor/na je krijgt.

^* Een kort antwoord op deze onderzoeksvraag formuleer je OOK en zet je in het issue, typisch tijdens week 3, IN het issue, zodat vraag en antwoord bij elkaar te vinden zijn voor beoordelaars.

Tip 2 april: Moeten deze vragen en antwoorden OOK in het Software Guidebook?

Kort antwoord: nee respectievelijk ja :).

TL; DR

Moeten deze vragen en antwoorden OOK in het Software Guidebook?

Het tijdens (spike) onderzoek gevonden antwoord komt OOK terug in je Software Guidebook. Want het was blijkbaar relevant (genoeg) voor je product om een antwoord op te krijgen. Maar het antwoord komt typisch NIET terug in het vraag/antwoord-format zoals in je issue, maar in een andere vorm. Een Software Guidebook bevat namelijk doelbewust GEEN hoofdstuk 'Vragen/Antwoorden' of FAQ o.i.d. Het SGB beantwoordt WEL vragen, maar als onderdeel van de toelichting bij een ontwerpbeslissing of een ontwerpprincipe. De vorm die je kies is aan jezelf hoe deze het meest past; goed technisch schrijven is namelijk ook een kwestie van goed structureren en organiseren van informatie. Je kunt het antwoord op een onderzoeksvraag bijvoorbeeld verwerken in de toelichting bij een ontwerpbeslissing in je Decision Log, of als toelichting bij een passend diagram. Het stukje aanpassing aan je SGB markdown commit je dan ook netjes op het issuenummer van de onderzoeksspike, zodat je vanuit GitHub issue kunt doorklikken, en een uitgebreider antwoord op de onderzoeksvraag en direct in context van je SGB.