Präsentera ett annat projekt

Fredag den 08:e januari 2021

I denna workshop ska ni jobba med en annan grupps projekt.

Under dagen är det tanken att ni ska läsa, förstå och lokalt köra en annan grupps projekt. Och göra en präsentation om projektet.

Ni får en branch (review-gX) som den som det är tänkt att ni jobbar emot, ni uppmanas till att förbättre dokumentation och evt kod.

Ni får också en pull request (bör vara ett issue), denna kan ni använda till att kommunicera med gruppen, om ni har frågor till koden, dokumentationen eller hur sakar hänger ihop. Men vänta inte på ett svar ;)

Presentaionen ska byggas upp runt dokumentations modellen C4, använd gärna draw.io / diagrams.net:

• Offical Homepage:The C4 model for visualising software architecture
• The C4 Model for Software Architecture
• Wikipedia: C4 model
• Video (35 min): Visualising software architecture with the C4 model
• C4 Modelling plugin for draw.io

Kom ihåg att präsentationen och dokumentation ni skaper ska delas med den grupp ni gör review av, det enklaste är att lägga det direkt i Confluence eller som ett commit i branchen (review-gX).

Vem gör vad:

• Grupp 1 genomgår och presentera Grupp 4, branch (review-g1) och pull request
• Grupp 2 genomgår och presentera Grupp 1, branch (review-g2) och pull request
• Grupp 3 genomgår och presentera Grupp 5, branch (review-g3) och pull request
• Grupp 4 genomgår och presentera Grupp 3, branch (review-g4) och pull request
• Grupp 5 genomgår och presentera Grupp 2, branch (review-g5) och pull request

Ni har förjande ressourser:

• GitHub (kod)
• Confluence
• Jira
• Discord historik

Presentaion för klassen, start kl 14:00. Ordning:

• Grupp 1
• Grupp 2
• Grupp 3
• Grupp 4
• Grupp 5

Presentaionen ska innehålla:

• En beskriving av vilken dokumentation som finns
  • Och vart den finns
  • Finns olika delar på olika ställen?
• En beskriving av hur det gick att få lösningen att köra lokalt
  • Vilka komando har ni kört?
  • Lokal build? Docker? Docker-compose?
• Infrastruktur
  • Vilka miljöer är där?
  • Hur kommer man åt dom?
  • När deployas dom?
• Branching (och merging) strategi (övergripande)
  • Hur är det tänkt att man ska jobba med koden?
• En C4 dokumentation av projektet
  • Context
  • Container
  • Component

Frågor som ni kommer att skulle ta ställning till efter präsentation:

• GruppX: känner ni igen det system som beskrivs av GruppY?
• GruppX: är där något som GruppY har glömt i deras presentation?
• GruppY: är där något av GruppX dokumentation som ni vill ta med er in i ert eget projekt?