Bijdragen aan open source-projecten: een handleiding voor beginners

Maar als je nog nooit hebt bijgedragen aan een open source-project, weet je misschien niet wat er van je wordt verwacht. Daarom leggen we in dit artikel uit wat je kunt doen als beginnende bijdrager aan open source-projecten. Het goede nieuws? Je hoeft niet eens te weten hoe je code moet schrijven.

‍

Voorbeelden van bijdragen aan open source-projecten

Als je niet zeker weet of je codeervaardigheden goed genoeg zijn om bij te dragen aan een open source-project, maak je geen zorgen, je staat hierin niet alleen. Veel nieuwe en zelfs ervaren programmeurs hebben deze zorg, en dat is jammer. Je kunt nooit alles weten, en dat moet je ook niet proberen. Het mooie van bijdragen aan open source-projecten is dat je gaandeweg veel zult leren.

Soms moet je er gewoon in duiken en de sprong wagen. Vaak blijken onbekende dingen die op het eerste gezicht intimiderend lijken, beter beheersbaar te zijn dan verwacht. Hetzelfde zal waarschijnlijk het geval zijn wanneer u bijdraagt aan een open source-project

Er zijn veel manieren waarop je kunt bijdragen aan een open-source project. Hieronder staan enkele voorbeelden:

1. Documentatie verbeteren

Een goede manier om bij te dragen aan open source-projecten is door de documentatie te verbeteren. Dit is voor veel mensen vaak een mooie eerste stap. Heb je bijvoorbeeld uitdagingen ondervonden toen je probeerde uit te zoeken hoe je een softwaretool moest gebruiken? Als je iets hebt moeten uitzoeken omdat de juiste documentatie ontbrak, is dit een geweldige kans om de documentatie te verbeteren en zowel ontwikkelaars als andere gebruikers te helpen.

In veel softwareprojecten wordt documentatie opgeslagen in dezelfde opslagplaats als de code. GitLab bewaart bijvoorbeeld alle documentatie in de map „doc” van een project. Als je de documentatie niet kunt vinden in de repository, kijk dan op de website van het project voor documentatie, zoals die van GitLab docs.gitlab.com.

2. Aan problemen werken

Een andere mogelijkheid is om bij te dragen door aan vraagstukken te werken. U zou kunnen beginnen met het schrijven van bugrapporten voor problemen die u tegenkomt/tegenkomt tijdens het gebruik van de software. Als u zich eenmaal op uw gemak voelt, kunt u doorgaan met het uittesten van problemen. Triage betekent het maken van de eerste beoordeling van de urgentie van een probleem.

Triage werkt op deze manier: kies een bestaand probleem en probeer het op je systeem te reproduceren. Als dat lukt, schrijf dan stapsgewijze instructies op over wat er gebeurt en voeg ze toe als opmerking over het probleem. Dit zal de ontwikkelaar later helpen bij het oplossen van de bug. Als je het probleem niet kunt reproduceren, vraag dan de eigenaar van het probleem om meer informatie.

3. Bugs oplossen en aan een nieuwe functie werken

Als je kunt coderen, kun je ook bijdragen door bugs op te lossen en nieuwe functies te bouwen. Misschien ben je zelf een bug tegengekomen tijdens het gebruik van de software? Je kunt een bijdrage leveren door te helpen creëren een oplossing voor die bug en ervaar de voldoening om een oplossing te creëren voor een probleem waar je mee te maken hebt gehad.

‍

Richtlijnen voor bijdragen aan open source-projecten

Veel opensourceprojecten hebben hun eigen „richtlijnen voor bijdragen”. Als bijdrager wordt van je verwacht dat je deze richtlijnen volgt. Ze zijn er om het proces voor iedereen gemakkelijker te maken. Op deze manier hoeven beheerders niet steeds te vragen om wijzigingen in de manier waarop de code is geschreven. Door deze richtlijnen te volgen, vergroot je de kans dat je bijdragen worden geaccepteerd.

Het is belangrijk om de richtlijnen voor bijdragen zorgvuldig te lezen, vooral als je bugs oplost of aan nieuwe functies werkt. De richtlijnen voor bijdragen zijn vaak te vinden in de repository van het project, meestal in een Contributing.md-bestand. Om het vinden van deze handleidingen gemakkelijker te maken, voegt GitLab automatisch een link toe naar de „Contributiegids” op de startpagina van het project als er een Contributing.md-bestand in de repository staat.

‍

Draag bij aan GitLab

GitLab is een voorbeeld van een groot open source-project waarbij iedereen welkom is om bij te dragen. Als je wilt ervaren hoe het voelt om bij te dragen aan zo'n groot project, ben je vrij om deel te nemen aan GitLab via een van de hierboven genoemde activiteiten.

Veel mensen vinden het een leuke en leerzame ervaring om bij te dragen aan open source-projecten. Ons advies, zeker als het je eerste keer is: begin klein. Je zult zien dat je bij elke stap meer zelfvertrouwen krijgt en grotere uitdagingen aangaat.

Veel succes en veel plezier!