Vind hulp als Git je verrast

Uiteindelijk toont Git een melding die je nog niet hebt gezien. Dat betekent niet dat je elke melding vooraf moet onthouden. Het is een reden om een betrouwbare manier te hebben om uit te zoeken wat Git weet en wat een opdracht betekent.

Begin bij de repository, niet bij een gok

Als iets in een repository je verrast, begin dan met git status. Je kent die opdracht al: ze noemt de huidige branch, meldt een onvoltooide merge en onderscheidt klaargezette, niet-klaargezette en untracked paden. Lees het hele resultaat voordat je een herstelactie kiest.

Een foutmelding bevat vaak twee soorten informatie. Het eerste deel vertelt wat Git weigerde te doen. Latere regels stellen mogelijk een opdracht voor of benoemen de toestand die je eerst moet oplossen. Zie die regels als bewijs, niet als een opdracht om alles wat je ziet te kopiëren. Een suggestie kan bij de ene bedoeling passen en bij een andere verkeerd zijn.

Schrijf je vraag in gewone woorden op voordat je zoekt. “Op welke branch sta ik?” is nuttiger dan “Git stuk”. “Hoe kiest restore een bron?” is nuttiger dan een onbegrepen opdracht plakken en hopen dat ze van toepassing is.

Vraag Git om de handleiding van één opdracht

Git bevat handleidingen voor zijn opdrachten. In git help <command> is het woord tussen punthaken een placeholder: vervang <command> door de opdracht die je wilt begrijpen. Het volgende vraagt bijvoorbeeld om de handleiding van git status:

git help status

Afhankelijk van je computer opent Git de handleiding in een terminalpager of webbrowser. Opent ze in een pager, druk dan op q om terug te gaan naar de prompt. Een handleiding lezen verandert de repository niet.

De handleiding is een naslagwerk, geen les die je van boven naar beneden moet lezen. Begin met de beschrijving en zoek daarna de optie of term uit de melding die je onderzoekt. Stop zodra je de vraag kunt beantwoorden die je er bracht.

Gebruik de officiële webdocumentatie als dat handiger is

De officiële Git-documentatie biedt dezelfde opdrachthandleidingen op een doorzoekbare webpagina. Dat is handig als het leesprogramma in de terminal onbekend is, als je links tussen verwante begrippen wilt of als je op een ander apparaat leest.

Versienummers doen ertoe als een handleiding gedrag beschrijft dat jouw geïnstalleerde Git niet herkent. git --version vertelt welke versie je hebt. In de webdocumentatie kun je zo nodig oudere documentatie kiezen. Neem niet aan dat een willekeurig voorbeeld en jouw installatie even oud zijn of dezelfde instellingen hebben.

Deze manier van hulp zoeken is geen nieuwe beoordeling en geen opdracht die je voor de cursus moet uitvoeren. Zo ga je veilig verder als de voorbereide oefeningen klaar zijn: lees de toestand, benoem de vraag, raadpleeg de relevante documentatie en maak de kleinste wijziging die je kunt controleren.