Patches die we aanvaarden. Patches die we afwijzen.

Een open bijdragersproces — licht uitgesproken over discipline, nooit over wie je bent.

Kies iets om aan te werken

De repository labelt first-touch-issues als good-first-issue. De maintainers triageren deze om te bevestigen dat de scope eerlijk is en de stappen duidelijk zijn. Maak je er een af, laat het label dan staan — het helpt de volgende persoon.

Open voor groter werk eerst een discussie. We zeggen ja, nee, of nog niet, en dit is waarom. Nee zeggen hoort bij het respecteren van je tijd.

Teken je commits

shell# in your local clone
git config user.signingkey YOUR_KEY_FINGERPRINT
git config commit.gpgsign true
git config tag.gpgsign true

We vereisen GPG-getekende commits. Dit gaat niet over gatekeeping — het gaat erom de supply chain van het project eerlijk te houden. Heb je nog geen sleutel, dan loodst de repository-wiki je door het genereren ervan.

Sign-off-regel

Elk commit-bericht moet eindigen met een Developer Certificate of Origin-sign-off (Signed-off-by: Name <email>). Gebruik git commit -s om het automatisch toe te voegen.

Schrijf een conventioneel commit-bericht

commit-berichtfeat(lsia): emit telemetry on safe-mode entry

Adds a single counter when the immune-system engine enters safe mode.
The counter is hashed-pattern only and respects the privacy gate.

Refs: #842
Signed-off-by: A. Researcher <a@example.org>

We volgen de Conventional Commits-spec voor de eerste regel. De body legt het waarom uit. De footer verwijst naar issues of gerelateerde wijzigingen.

Open de pull request

Pull requests doorlopen drie geautomatiseerde poorten en een menselijke review:

De reproduceerbare-build-controle verifieert dat je patch het determinisme niet breekt.
De privacy-poort verifieert dat er geen pad voor ruwe data is toegevoegd.
De suite van unit- en integratietests moet slagen.
Twee reviewers keuren goed vóór de merge. Beveiligingsgevoelige delen vereisen een security-reviewer.

Als de privacy-poort faalt

Stop. Herlees de diff zorgvuldig — de test faalt wanneer een codepad ruwe identificatoren zou kunnen lekken (IP, e-mail, IMEI, GPS). De oplossing is bijna nooit de test uitschakelen.

Erkenning

Elke aanvaarde bijdrage verschijnt in de volgende release notes — met vermelding, tenzij je om anonimiteit vraagt. Het AUTHORS-bestand wordt automatisch bijgewerkt zodra je voor het eerst een wijziging merget.

Voor groter werk — een grote feature, een audit, een vertaling — noemt de changelog-entry je bij naam. Anonieme vermelding is een normaal verzoek, geen bijzonder verzoek.

Gedragscode

We volgen het Contributor Covenant 2.1. Persoonlijke aanvallen, bedreigingen, doxxing en intimidatie zijn overtredingen die tot onmiddellijke verwijdering leiden, zonder vereiste klachtenketen. De volledige tekst staat in de repository CODE_OF_CONDUCT.md.