Vill du förbättra ditt rykte på GitHub? Så här formaterar du kommunicera meddelanden.
Istället för att skriva en rad git begå meddelanden med begå -m alternativ, i den här artikeln lär du dig att skriva riktiga kommunicera meddelanden. Ett riktigt meddelande är viktigt eftersom det låter andra se exakt vad du har ändrat, gör ditt projekt lättare för andra att följa och hjälper dig att öka din exponering för öppen källkod gemenskap.
Skriv ett ordentligt engagemangsmeddelande
Istället för att inkludera kommunicera meddelandet i terminalkommandot, öppna din favorit textredigerare till en tom fil. Meddelandet ska ha följande format:
Letar du efter en terminaltextredigerare för Linux? Huvudvalet är mellan Vim och nano! Så här jämför de.
- Första raden är titeln, som sammanfattar hela engagemanget.
- Efter en tom rad bör nästa rad eller flera rader vara någon läsbar beskrivning som är nödvändig för åtagandet. Detta kan vara så länge som önskat.
- Alla följande rader ska sammanfatta de exakta ändringarna i koden i ett sådant format:
- Filnamn: Rad # - Kort beskrivning av modifieringen.
Exempel på meddelande om åtagande
Nedan visas ett exempel på meddelande:
Tillagt Docker-stöd, ny is_unique-funktion, plus bug fix.
Lagt till stöd för docker-compose och uppdaterad installationsinstruktion efter behov. Inkluderade också en ny funktion inom check_order () -funktionen för att söka efter unikhet och fixade ett litet fel när du skapar produktsniglar.
src / somedir / library.py: 381 - Parametern 'is_unique' har lagts till i funktionen check_order ().
src / products.py: 194 - Fixat fel när du skapar produktsnigel.
docker-compose.yml - Tillagd docker-compose-fil.
docs / install.md - Uppdaterad installationsguide för att inkludera hur man installerar via Docker.
Begå meddelande
När du gör ett åtagande nu, istället för att använda -m använda meddelandet--fil alternativ. Till exempel, om filnamnet på ditt engagemangsmeddelande är commit.txt skulle du köra kommandot:
git commit --file commit.txt
Det är allt som finns! Förhoppningsvis hjälper detta dig att tillhandahålla mer standardiserade och tydliga meddelanden till dina följare, vilket hjälper ditt projekt att få exponering och hjälpa öppen källa samhället växer.
Bildkredit: Caleb White /Unsplash
Vill du dela dina utvecklingsprojekt online? Så här kommer du igång med ditt första Github-arkiv.
- Programmering
- GitHub
Prenumerera på vårt nyhetsbrev
Gå med i vårt nyhetsbrev för tekniska tips, recensioner, gratis e-böcker och exklusiva erbjudanden!
Ett steg till…!
Bekräfta din e-postadress i e-postmeddelandet som vi just skickade till dig.