So funktioniert es

Wir nehmen eure Patches und Beiträge zu diesem Projekt gerne entgegen. Es gibt nur ein paar kleine Richtlinien, die Sie beachten müssen.

Lizenzvereinbarung für Mitwirkende

Alle Beiträge zu einem Google-Projekt müssen einer Lizenzvereinbarung für Mitwirkende beigefügt werden. Hierbei handelt es sich nicht um eine urheberrechtliche Zuweisung, sondern lediglich um die Genehmigung von Google, Ihre Beiträge im Rahmen des Projekts zu verwenden und weiterzugeben.

  • Wenn Sie als Einzelperson Originalquellcode schreiben und sicher sind, dass Sie Inhaber des geistigen Eigentums sind, müssen Sie eine individuelle CLA unterzeichnen.

  • Wenn Sie für ein Unternehmen arbeiten, das Ihnen erlauben möchte, Ihre Arbeit beizusteuern, müssen Sie ein CLA für Unternehmen unterzeichnen.

Ein CLA muss in der Regel nur einmal eingereicht werden. Wenn Sie also bereits ein CLA eingereicht haben (auch wenn es für ein anderes Projekt vorgesehen war), müssen Sie dies wahrscheinlich nicht noch einmal tun.

Patch senden

  1. In der Regel ist es am besten, wenn Sie ein neues Problem erstellen, in dem der Fehler oder die Funktion beschrieben wird, die Sie beheben möchten. Auch wenn Sie das Projekt für relativ gering halten, ist es hilfreich zu wissen, woran die Leute arbeiten. Erwähnen Sie im ersten Problem, dass Sie an dem Fehler oder der Funktion arbeiten möchten, damit sie Ihnen zugewiesen werden kann.

  2. Folgen Sie dem normalen Vorgang zum Verzweigen des Projekts und richten Sie einen neuen Zweig ein, mit dem Sie arbeiten möchten. Es ist wichtig, dass jede Gruppe von Änderungen in separaten Zweigen erfolgt, damit eine Pull-Anfrage nur die Commits enthält, die sich auf den jeweiligen Fehler oder dieses Feature beziehen.

  3. Bei wesentlichen Änderungen sollten fast immer Tests durchgeführt werden. Das Projekt hat bereits eine gute Testabdeckung. Sehen Sie sich daher einige der vorhandenen Tests an, wenn Sie nicht sicher sind, wie Sie vorgehen sollen.

  4. Versuchen Sie, für jede Änderung korrekt formatierte Commit-Nachrichten zu erhalten. Dies sorgt für Konsistenz im gesamten Projekt und sorgt dafür, dass Commit-Nachrichten von verschiedenen Git-Tools richtig formatiert werden können.

  5. Übertragen Sie die Commits abschließend in die Verzweigung und senden Sie eine Pull-Anfrage.