Identifizieren, wo Hilfe benötigt wird

Abgeschlossen

In dieser Lerneinheit wird erläutert, wie Sie mit Open-Source-Beiträgen beginnen können. Außerdem werden Issues und Tags verwendet, um Aufgaben zu finden, zu denen Sie beitragen können.

Open-Source-Software kann von jedem Menschen kostenlos verwendet, geändert und mit anderen gemeinsam genutzt werden. Mit Open-Source-Software kann jeder Mensch ein Projekt für einen beliebigen Zweck anzeigen, ändern und verteilen. Open-Source-Software basiert auf dem Gedanken, dass die gemeinsame Nutzung von Code zu besserer, zuverlässigerer Software führt.

Es gibt viele Möglichkeiten, zu Open-Source-Projekten beizutragen. Den ersten Beitrag einzureichen, kann beängstigend sein, aber das sollte nicht so sein. Bei Open-Source-Projekten wird niemand ausgeschlossen, und Beiträge können zu den unterschiedlichsten Bereichen eingereicht werden.

Suchen nach einem Open-Source-Projekt, das Beiträge benötigt

Sie können damit beginn, sich über die Projekte Gedanken zu machen, die Sie bereits verwenden oder noch verwenden möchten. Der Beitrag ist einfacher, wenn Sie mit dem Projekt und der Community vertraut sind.

Wenn Sie die README-Datei (Infodatei) eines Projekts lesen, stoßen Sie vielleicht auf einen fehlerhaften Link oder einige Rechtschreibfehler. Vielleicht haben Sie bemerkt, dass etwas nicht wie erwartet funktioniert oder die Dokumentation veraltet ist. Das sind tolle Möglichkeiten, beim Projekt mitzuwirken und Hilfe beizutragen.

Tipp

Wichtiger Tipp: Alle Arten von Beiträgen sind wertvoll. Ihr Erfahrungsniveau oder Wissen in Bezug auf das Projekt ist hier nicht von Bedeutung. Jeder kann etwas beitragen. Trauen Sie sich etwas zu. Das Wichtigste hierbei ist, helfen zu wollen.

Sie können auch die GitHub-Suche verwenden, um Themen und verwandte Projekte zu untersuchen. Wechseln Sie zur GitHub-Suche, und geben Sie den Themenbegriff ein.

Angenommen, Sie interessieren sich für maschinelles Lernen.

Screenshot showing GitHub search topics.

Sie können dann die Suche eingrenzen, indem Sie auf der linken Randleiste auf Topics (Themen) klicken.

Screenshot showing the results of a GitHub narrow search.

Von dort aus können Sie die für das Suchschlüsselwort relevanten und die von Communitymitgliedern kuratierten Repositorys suchen.

Vertrautmachen mit einem Open-Source-Projekt

Es muss hier erwähnt werden, dass jede Open-Source-Community anders ist. Nachdem Sie ein Projekt gefunden haben, müssen Sie sich mit dem Projekt und seinen Teilnahmerichtlinien vertraut machen.

In den meisten Projekten sind diese Dokumente auf der obersten Ebene des Repositorys enthalten:

  • LICENSE (Lizenz): Das Projekt muss eine Open-Source-Lizenz enthalten. Wenn das Projekt nicht über eine Lizenz verfügt, ist es nicht Open Source.
  • README: Die Infodatei dient in der Regel als Willkommensseite für das Projekt. Sie enthält im Allgemeinen Informationen zu den ersten Schritten mit dem Projekt. Es ist auch üblich, Informationen darüber hinzuzufügen, wie Sie mit der Community in Kontakt treten.
  • CONTRIBUTING (Beitragen): Wie der Name schon vermuten lässt, stellt dieses Dokument Anweisungen dazu bereit, wie Sie zum Projekt beitragen können. In der Regel wird beschrieben, wie der Beitragsprozess funktioniert, und es wird erläutert, wie Sie Ihre Entwicklungsumgebung einrichten.
  • CODE_OF_CONDUCT: Die Verhaltensregeln legen die Grundregeln für Communitymitglieder fest. Dadurch wird die Community zu einer sicheren und einladenden Umgebung für alle.

Obwohl nicht alle Projekte CONTRIBUTING- oder CODE_OF_CONDUCT-Dokumente aufweisen, ist das Vorhandensein dieser Dokumente jedoch ein guter Hinweis darauf, wie freundlich und einladend ein Projekt gestaltet ist.

Mitwirkende und Maintainer von Open-Source-Anwendungen kommen aus der ganzen Welt. Projekte verfügen in der Regel über mehrere Kommunikationskanäle zum Organisieren von Diskussionen und zum Anfordern von Hilfe. Sie können sich einige dieser Kommunikationskanäle durchlesen, um sich mit der Community vertraut zu machen:

  • Issue Tracker (Problemnachverfolgung): Dies ist der Ort, an dem Benutzer die im Zuge des Projekts aufgetretenen Issues und Aufgaben besprechen. Sie können zur Hauptseite des Repositorys auf GitHub navigieren und am Ende der URL /issues hinzufügen (z. B. https://github.com/jupyter/notebook/issues), um die Issues auf GitHub zu ermitteln.
  • Pull Request: Hier werden Änderungen am Projekt besprochen und überprüft. Sie finden diesen Kanal auf GitHub, indem Sie der Projekt-URL pulls hinzufügen (z. B. https://github.com/jupyter/notebook/pulls).
  • Chatkanäle und Foren: In einigen Projekten werden Chatkanäle (z. B. Slack, Gitter und IRC) oder Foren (z. B. Discourse) für Konversationen und Diskussionen verwendet.

Identifizieren von Aufgaben zur Bearbeitung

Sie haben ein Projekt gefunden und die Beitragsrichtlinien gelesen. Jetzt sind Sie bereit, Ihren Beitrag zu übermitteln.

Vielleicht haben Sie bereits etwas gefunden, das bearbeitet werden soll. Sollen möglicherweise fehlerhafte Links behoben oder die Dokumentation aktualisiert werden? Eine gute Möglichkeit, für Anfänger geeignete Issues zu finden, ist die Verwendung der /contribute-URL des Projekts (z. B. https://github.com/jupyter/notebook/contribute).

Screenshot showing the Contribute to a project section on GitHub.

Sie werden feststellen, dass die meisten der in der contribute-URL angezeigten Issues Bezeichnungen wie good-first-issue, help wanted, beginner-friendly usw. aufweisen. Bezeichnungen werden häufig verwendet, um Informationen der obersten Ebene zum Issue sowie zur erforderlichen Hilfe bereitzustellen.

Sie können zur Seite „Bezeichnungen“ wechseln (z. B. https://github.com/jupyter/notebook/labels). Wählen Sie dann Issues aus, die über Bezeichnungen wie help wanted, discussion oder andere relevante Bezeichnungen zum Typ des Beitrags verfügen, an dem Sie interessiert sind.

Wenn Sie Issues untersuchen, bemerken Sie möglicherweise auch, dass bei einigen andere Issues oder Pull Requests verknüpft sind.

Screenshot showing a pull request linked to an issue.

Es gibt viele Möglichkeiten, zu Open Source beizutragen. Sie können die Mitarbeiter, die das Open-Source-Ökosystem entwickeln und verwalten, über Code, Führungskräfte, Unterstützung und Beratung, Entwürfe und darüber hinaus unterstützen.

Open Source basiert stark auf der Freiwilligenarbeit. GitHub Sponsors ermöglicht Ihnen das Finanzieren von Projekten und Einzelpersonen, damit diese ihre Open-Source-Arbeit fortsetzen können und dafür die verdiente Anerkennung bekommen.

Wenn ein Projekt für die Förderung durch GitHub Sponsors infrage kommt, finden Sie auf der Hauptseite des Projekts die Schaltfläche Sponsor (Fördern).

Screenshot showing the sponsoring box on a GitHub project page.

Sie können den Tarif „Sponsorship“ auswählen, wenn Ihr Beitrag öffentlich sein soll.

Screenshot showing sponsorship tiers.

Fazit der Lerneinheit

In dieser Einheit haben Sie einen Überblick darüber erhalten, wie Sie einen Beitrag zu Open-Source-Projekten leisten können. Sie haben erfahren, wie Sie ein Projekt auswählen, an dem Sie arbeiten möchten. Außerdem wurde erklärt, wie Sie GitHub-Issues und -Labels verwenden, um Aufgaben zu ermitteln, an denen Sie arbeiten können.

Hier finden Sie eine praktische Checkliste für Ihre erste Beteiligung an einem Projekt:

  • Ist eine Lizenz verfügbar?
  • Werden Diskussionen zu Issues und Pull Requests von Maintainern und Mitwirkenden aktiv genutzt?
  • Verwendet das Projekt Labels wie help wanted oder good first issue für Einsteiger?
  • Gibt es Verhaltensregeln für das Projekt?
  • Gibt es klare Richtlinien für Beiträge zu dem Projekt?

Wir möchten noch einmal betonen, dass jeder Beitrag willkommen ist und das Open-Source-Ökosystem von Ihren Ideen und Beiträgen profitiert. Es gibt zahlreiche Möglichkeiten, an Open-Source-Projekten mitzuwirken. Beispielsweise können Sie Code einreichen, sich an Projektdiskussionen beteiligen oder Projekte über GitHub Sponsors fördern.