Teknik 2 · Kapitel 24
Versionshantering och presentation av tekniska lösningar
Tekniska lösningar behöver kunna förstås, användas och utvecklas av andra.
Versionshantering
Spara förändringar med sammanhang
- jämför versioner
- se vem som ändrade vad
- återställ ett tidigare läge
- arbeta parallellt i grenar
Git och GitHub
Verktyg och samarbetsplattform
| Git | GitHub |
|---|---|
| Versionshanteringssystem | Webbaserad tjänst för Git-repositorier |
| Kan användas lokalt | Lagrar och delar projekt online |
| Commit, branch och merge | Pull requests, granskning och ärenden |
GitHub använder Git, men Git är inte samma sak som GitHub.
En bra commit
En begriplig förändring
Otydligt
fixTydligt
Rätta validering av tom e-postadressEn commit bör vara avgränsad och beskriva vad förändringen åstadkommer.
Presentation
Välj budskap före detaljer
- Vad ska mottagaren förstå?
- Vad behöver mottagaren besluta eller göra?
- Vilka bevis och exempel behövs?
- Vilka tekniska detaljer kan vänta?
En presentation är ett urval – inte all dokumentation uppläst.
Visuell kommunikation
Visa relationen som ska förstås
| Flödesschema | Ordning och beslut |
|---|---|
| Systemdiagram | Komponenter och kopplingar |
| Skärmbild | Gränssnitt och visuellt resultat |
| Diagram | Mängder, förändring och jämförelse |
| Demonstration | Faktiskt beteende i användning |
Förklara ett system
Från helhet till detalj
Mottagaren behöver en karta innan de tekniska detaljerna blir begripliga.
Elevator pitch
Förklara nyttan på en minut
För [målgrupp] som har [problem] erbjuder vår lösning [funktion]. Den skapar [nytta], till skillnad från [alternativ].
Fokusera på problem, mottagare och värde – inte en lista över all teknik.
Interaktiv pitchbyggare
Formulera kärnan
Fyll i fälten och skapa en pitch.
Webbplatsprojekt
Tre spår genom hela projektet
| Kommunikation | Diskutera krav, design, status och problem. |
|---|---|
| Dokumentation | Beskriv struktur, dataflöden, kod och tester. |
| Presentation | Demonstrera webbplatsen och förklara nyttan. |
Unity-projekt
Förklara både regler och upplevelse
| Kommunikation | Samordna spelmekanik, nivåer, grafik och kod. |
|---|---|
| Dokumentation | Beskriv system, skript, tillgångar och testresultat. |
| Presentation | Visa spelet och demonstrera centrala funktioner. |
Loggbok
Dokumentera arbetets utveckling
- vad gjorde jag?
- varför valde jag denna lösning?
- vilka problem uppstod?
- hur testades och förbättrades resultatet?
- vad är nästa steg?
En bra loggbok beskriver beslut och lärande, inte bara en lista över aktiviteter.
Interaktivt beslut
Vilken dokumentation behövs?
En ny utvecklare ska underhålla en koppling mellan en webbplats och ett betalningssystem.
Praktisk övning
Dokumentera och presentera en lösning
- Välj en teknisk lösning och två mottagare.
- Skapa en enkel systembeskrivning.
- Skriv en kort användarguide.
- Förbättra namn och kommentarer i ett kodexempel.
- Skapa en tydlig visuell modell.
- Presentera lösningen på en minut.
Exit ticket
Tre frågor
- Hur skiljer sig dokumentation från presentation?
- När hjälper en kodkommentar – och när behövs tydligare kod?
- Vad skiljer Git från GitHub?
Sammanfattning
Kom ihåg
- Kommunikation skapar gemensam förståelse och samordning.
- Dokumentation bevarar kunskap om system och beslut.
- Tydlig kod och relevanta kommentarer kompletterar varandra.
- Git hanterar versioner; GitHub stödjer lagring och samarbete.
- En presentation anpassar budskap och detaljer till mottagaren.