Bijdragen
Alle bijdrages zijn welkom en zullen met alle respect en dankbaarheid behandeld worden.
Maar voor u start met uw bijdragen raden wij u aan om de onderstaande richtlijnen en standaarden door te nemen voor u een issue of pull request aanmaakt.
Etiquette
Dit project is volledig open-source, dit betekend dat de ontwikkelaar(s) die het project onderhouden hun vrije tijd hierin steken. Omtrent het onderhoud van de code en ontwikkelen van nieuwe features. Ze stellen de source-code ter beschikking in de hoop dat het ook nuttig kan zijn voor andere ontwikkelaars. Het zou extreem ondankbaar zijn als zij gevallen van fustratie of mentale scheld tiradres op hun bord krijgen in ruil voor het harde werk dat zij leveren.
Daarom vragen we u om rekening te houden met de maintainers en community tijdens de melding van problemen en of het aanmaken van een pull request. Laat zien dat ontwikkelaars beschaafde en onbaatzuchtige mensen zijn.
Het is de plicht van de beheerder(s) om ervoor te zorgen dat alle inzendingen voor het project van voldoende kwaliteit zijn om het project ten goede te komen. Veel ontwikkelaars hebben verschillende vaardigheden, sterke en zwakke punten. Respecteer de beslissing van de beheerde en wees niet overstuur of beledigend als uw inzending niet wordt gebruikt.
Vatbaarheid
Als u nieuwe functionaliteit of indient moet u eerst overwegen of dit nuttig kan zijn voor anderen. Open-source projecten worden door veel ontwikkelaars gebruikt, die mogelijk geheel andere behoeften hebben dan uw eigen. Bedenk of uw functionaliteit waarschijnlijk door andere gebruikers van het project zal worden gebruikt.
Procedure
Voor een issue aanmaakt:
- Probeer het probleem te repliceren om ervoor te zorgen dat het geen toevallig incident was.
- Controleer of uw suggestie voor de functie nog niet aanwezig is in het project.
- Controleer het tabblad met pull requests om er zeker van te zijn of de bug nog geen oplossing heeft.
- Controleer het tabblad met pull requests om er zeker van te zijn dat de bug nog geen oplossing heeft die wordt ontwikkeld.
Voor u een pull request aanmaakt:
- Check de codebase om uit te sluiten dat je functiionaliteit al niet is toegevoegd.
- Check het pull requests tabblad om er zeker van te zijn dat een andere persoon de fix of functionaliteit al niet aan het opbouwen is.
Vereisten
Als de project ontwikkelaar enige bijkomende vereisten of standaarden heeft, Zal u deze hieronder vinden.
- PSR-2 Coding standard - De gemakkelijkste weg voor het implmenteren van de standaard is het installeren van PHP Code Sniffer.
- Add documentation! - Uw patch za niet worden geaccepteerd als het niet de nodige documentatie toevoegen of wijzigingen bezit.
- Overweeg onze release cycle - We proberen om de SmeVer 2.0.0 standaard te implementeren. Het random breken van functionaliteit is geen optie.
- Een PR per feature of bug - Indien u meerdere bijdrages wilt leveren vragen wij u 1 bijdrage per pull request aan te leveren.
- Houd een coherente geschiedenis aan - Zorg ervoor dat elke afzonderlijke commit in je PR zinvol is. Als je tijdens het ontwikkelen meerdere tussentijdse commits moest maken squash je ze voordat je ze indient.
Voor de rest wensen we je veel success en al het nodige plezier met je bijdrage te leveren. En bedanken we je voor het doornemen van de richtlijnen omtrent bijdrages.