Versiebeheer: de verzekering van elke softwaremaker

Versiebeheer is het bewaren van elke versie van je code, met een aantekening erbij wat er veranderde. Zonder versiebeheer is één verkeerde opdracht aan je agent genoeg om dagen werk kwijt te raken. Met versiebeheer is dat één commando om terug te draaien. Het is ook de manier waarop softwaremaken.nl naar je code kijkt om hem live te zetten.

De woorden

Vier begrippen, dan ben je er:

• Git is het programma dat versies bewaart, op je eigen computer. Je agent gebruikt het voor je.
• GitHub is een website waar je die versies ook online bewaart, gratis voor wat wij doen.
• Een repository is de map met je code op GitHub. Eén app, één repository.
• Een commit is één bewaarde versie, met een korte omschrijving: "Behandelingen tonen op de startpagina" is een commit.

Een account en een repository

Maak op github.com een gratis account met een e-mailadres dat je vaak leest, en zet meteen tweestapsverificatie aan: je code is straks je bedrijf, een wachtwoord alleen is niet genoeg. Maak daarna een nieuwe, privé repository met de naam van je app in kleine letters met streepjes. Verder hoef je niets aan te vinken; de rest doet je agent, of je begint vanuit een sjabloon via "Use this template" als je dat aangeboden krijgt.

Elke werkende versie bewaren

Vanaf nu geldt: elke keer als iets werkt, laat je je agent committen en naar GitHub sturen. Dat is één opdracht: "Commit dit met een duidelijke omschrijving en push naar GitHub." Een goed commit-bericht zegt in de tegenwoordige tijd, in één regel, wat er veranderde: "Voeg formulier toe om een afspraak te maken", niet "update" of "fix". Over een half jaar wil je nog kunnen lezen wat je toen deed.

Terug naar een vorige versie

Dit is waarom je het allemaal doet. Gaat er iets mis en werkt de app niet meer? Zeg tegen je agent: "Zet alle bestanden terug naar de laatste commit." De kapotte wijzigingen zijn weg; de laatste werkende versie is terug. Wil je verder terug, dan laat je je agent de eerdere commits tonen en wijs je aan naar welke versie hij moet teruggaan.

Koppelen aan softwaremaken.nl

Zodra je code op GitHub staat, koppel je de repository aan je project in het dashboard. Je installeert dan onze GitHub-app, een klein programma dat alleen die ene repository mag lezen en er de gegevens voor het automatisch live zetten in mag plaatsen. Je code blijft van jou; wij maken nooit repositories in onze eigen naam, en stop je bij ons, dan neem je alles mee. Vanaf het koppelen staat je project in je dashboard, klaar om live te zetten.