DokumentationBEITRAGEN

BEITRAGEN

Patches, die wir annehmen. Patches, die wir ablehnen.

Offener Mitwirkungsprozess — leicht eigensinnig bei der Disziplin, niemals dabei, wer du bist.

01

Such dir etwas zum Arbeiten

Das Repository kennzeichnet Einsteiger-Issues als good-first-issue. Die Maintainer triagieren diese, um zu bestätigen, dass der Umfang fair und die Schritte klar sind. Wenn du eines erledigst, lass es markiert — das hilft der nächsten Person.

Für größere Arbeiten eröffne zuerst eine Diskussion. Wir sagen ja, nein, oder noch nicht, und hier ist der Grund. Nein zu sagen gehört dazu, deine Zeit zu respektieren.

02

Signiere deine Commits

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

Wir verlangen GPG-signierte Commits. Das geht nicht ums Gatekeeping — es geht darum, die Lieferkette des Projekts ehrlich zu halten. Falls du noch keinen Schlüssel hast, führt dich das Repository-Wiki durch die Erzeugung eines solchen.

Sign-off-Zeile
Jede Commit-Message muss mit einem Developer-Certificate-of-Origin-Sign-off enden (Signed-off-by: Name <email>). Verwende git commit -s, um es automatisch hinzuzufügen.
03

Schreib eine konventionelle Commit-Message

Commit-Messagefeat(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>

Wir folgen der Conventional Commits-Spezifikation für die erste Zeile. Der Body erklärt das Warum. Der Footer referenziert Issues oder verwandte Änderungen.

04

Eröffne den Pull-Request

Pull-Requests durchlaufen drei automatisierte Gates und ein menschliches Review:

  • Der reproduzierbarer-Build-Check verifiziert, dass dein Patch die Determinismus nicht bricht.
  • Das Datenschutz-Gate verifiziert, dass kein Rohdatenpfad eingeführt wurde.
  • Die Unit- und Integrations-Testsuite muss bestehen.
  • Zwei Reviewer genehmigen vor dem Merge. Sicherheitskritische Bereiche erfordern einen Security-Reviewer.
Wenn das Datenschutz-Gate fehlschlägt
Stopp. Lies das Diff sorgfältig erneut — der Test schlägt fehl, wenn ein Codepfad rohe Identifikatoren (IP, E-Mail, IMEI, GPS) leaken könnte. Die Lösung besteht fast nie darin, den Test zu deaktivieren.
05

Anerkennung

Jeder angenommene Beitrag erscheint in den nächsten Release-Notes — mit Credit, sofern du nicht um Anonymität bittest. Die AUTHORS-Datei wird beim ersten Merge einer Änderung automatisch aktualisiert.

Für größere Arbeiten — ein großes Feature, ein Audit, eine Übersetzung — nennt dich der Changelog-Eintrag namentlich. Anonyme Würdigung ist eine normale Bitte, keine besondere.

06

Verhaltenskodex

Wir folgen dem Contributor Covenant 2.1. Persönliche Angriffe, Drohungen, Doxxing und Belästigung sind Verstöße mit sofortigem Ausschluss, ohne erforderliche Beschwerdekette. Der vollständige Text steht im Repository-CODE_OF_CONDUCT.md.