GitHub-stroom verkennen

Voltooid

GitHub is het beste hulpprogramma om samenwerking in uw projecten mogelijk te maken. GitHub-stroom is een werkstroom op basis van een vertakking die wordt voorgesteld voor GitHub.

Notitie

Als u een GitHub-stroom wilt implementeren, hebt u een GitHub-account en een opslagplaats nodig. Zie 'Registreren voor GitHub' en 'Een opslagplaats maken'.

Fooi

U kunt alle stappen van GitHub-stroom voltooien via de GitHub-webinterface, opdrachtregel, GitHub CLI of GitHub Desktop.

De eerste stap is het maken van een vertakking in uw opslagplaats om te werken zonder dat dit van invloed is op de standaardbranch en u geeft medewerkers de kans om uw werk te beoordelen.

Zie 'Vertakkingen maken en verwijderen in uw opslagplaats' voor meer informatie.

Screenshot of a branching model representing the branch creation.

Breng de gewenste wijzigingen aan in de opslagplaats. Als u een fout maakt, kunt u extra wijzigingen terugzetten of pushen om deze te herstellen.

Voer uw wijzigingen door en push deze naar uw vertakking om een back-up te maken van uw werk naar externe opslag, waardoor elke doorvoering een beschrijvend bericht geeft. Elke doorvoering moet een geïsoleerde, volledige wijziging bevatten, zodat u eenvoudig kunt terugkeren als u een andere benadering gebruikt.

Iedereen die met uw project samenwerkt, kan uw werk zien, vragen beantwoorden en suggesties of bijdragen doen. Ga door met het maken, doorvoeren en pushen van wijzigingen naar uw vertakking totdat u klaar bent om feedback te vragen.

Fooi

U kunt voor elke wijziging een afzonderlijke vertakking maken om revisoren eenvoudig feedback te geven of om inzicht te krijgen in de verschillen.

Zodra u klaar bent, kunt u een pull-aanvraag maken om medewerkers te vragen om feedback over uw wijzigingen. Zie 'Een pull-aanvraag maken'.

Beoordeling van pull-aanvragen is een van de meest waardevolle functies van samenwerking. U kunt goedkeuring van uw collega's en team vereisen voordat u wijzigingen samenvoegt. U kunt het ook markeren als concept voor het geval u vroeg feedback of advies wilt voordat u uw wijzigingen voltooit.

Screenshot of a branching model representing an open a pull request.

Beschrijf de pull-aanvraag zoveel mogelijk met de voorgestelde wijzigingen en welk probleem u oplost. U kunt afbeeldingen, koppelingen, gerelateerde problemen of informatie toevoegen om uw wijziging te documenteren en revisoren te helpen de pull-aanvraag te begrijpen zonder elk bestand te openen. Zie 'Basissyntaxis voor schrijven en opmaken' en 'Een pull-aanvraag koppelen aan een probleem'.

Screenshot of open a pull request representation with description field, related issue and a checklist template.

Een andere manier om de kwaliteit en documentatie van pull-aanvragen te verbeteren en expliciet iets aan te wijzen aan de revisoren is door het gebied voor opmerkingensessies te gebruiken. U kunt @mention ook een beoordeling aanvragen bij specifieke personen of teams.

Screenshot of pull request comment field.

Er zijn andere configuraties voor pull-aanvragen, zoals het automatisch aanvragen van een beoordeling van specifieke teams of gebruikers wanneer er een pull-aanvraag wordt gemaakt of controles worden uitgevoerd op pull-aanvragen. Zie 'Over statuscontroles' en 'Over beveiligde vertakkingen' voor meer informatie.

Na de opmerkingen en controles van de revisoren moeten de wijzigingen gereed zijn om te worden samengevoegd en kunnen ze de pull-aanvraag goedkeuren. Zie Een pull-aanvraag samenvoegen.

Als er conflicten zijn, informeert GitHub u om ze op te lossen. "Samenvoegingsconflicten aanpakken."

Screenshot of a branching model representing the branch merge.

Nadat een geslaagde pull-aanvraag is samengevoegd, hoeft de externe vertakking daar niet te blijven. U kunt uw vertakking verwijderen om te voorkomen dat anderen per ongeluk oude vertakkingen gebruiken. Zie 'Vertakkingen verwijderen en herstellen in een pull-aanvraag' voor meer informatie.

Notitie

GitHub houdt de doorvoer- en samenvoeggeschiedenis bij als u uw pull-aanvraag wilt herstellen of terugzetten.