Sprint-Leitfaden

Willkommen bei den BeeWare Sprints!

Herzlich willkommen! Wir freuen uns, dass Sie sich entschlossen haben, bei uns mitzumachen! Falls Sie sich noch nicht noch nicht einem Mitglied des Bee-Teams vorgestellt haben, tun Sie dies bitte. Sobald Sie das getan haben, gehen Sie hierher zurück, um loszulegen.

Was ist ein Sprint?

Ein Sprint ist eine unstrukturierte Gelegenheit, ein paar Stunden oder Tage gemeinschaftlich an einem Open-Source-Projekt zu arbeiten. Sie sind oft verbunden mit einer Konferenz verbunden; ein Sprint nach einer Konferenz bietet die Gelegenheit, die die Energie, den Enthusiasmus und das Interesse, die eine Konferenz erzeugt hat in Verbesserungen der Software umzusetzen, die wir täglich nutzen.

Sprints sind auch eine Gelegenheit, Menschen in den Prozess der zum Projekt beizutragen. Unsere Hoffnung ist, dass Sie so viel Spaß haben während des Sprints so viel Spaß haben, dass Sie nach Hause gehen und weiter Beitrag leisten!

Es spielt keine Rolle, wie viel Erfahrung Sie haben. Bei früheren Sprints haben wir Beiträge von Menschen mit unterschiedlichem Erfahrungsniveau zusammengeführt – von Schülern über Absolventen von Bootcamps bis hin zu Menschen, die sich selbst nicht als Programmierer betrachten, und erfahrenen Entwicklern. Unabhängig von Ihrem Erfahrungsniveau finden wir eine Möglichkeit, wie Sie einen Beitrag leisten können.

Der Code ist auch nicht die einzige Möglichkeit, einen Beitrag zu leisten. Ein Projekt wie BeeWare ist viel mehr als nur der Code - wir brauchen Leute, die die Dokumentation schreiben, Dokumentation zu schreiben, Korrektur zu lesen und zu übersetzen; wir brauchen Leute, die das Design der Webseiten zu verbessern; selbst der Prozess der Durchsicht von Fehlern, die die vor Jahren gemeldet wurden, und festzustellen, dass sie inzwischen behoben wurden ist ein wertvoller Beitrag.

Die ersten Fragen

Um Ihnen den Einstieg zu erleichtern, werden wir Ihnen einige Fragen stellen, damit wir Ihre Ihre Interessen und Erfahrungen. Dies wird uns helfen, den besten Weg für wie Sie sich am besten einbringen können. Gehen Sie die Fragen durch, machen Sie sich Notizen, und suchen Sie dann ein Mitglied des Bee-Teams und teilen Sie Ihre Antworten mit. Wenn Sie die Frage die gestellte Frage nicht verstehen - keine Sorge! Lassen Sie uns wissen, was Sie was ihr wisst, und wir werden es gemeinsam herausfinden.

1. Haben Sie BeeWare schon einmal verwendet?

Wenn Sie dies noch nicht getan haben, beginnen Sie mit dem BeeWare-Tutorial. Dort erhalten Sie eine Einführung in das BeeWare-Projekt und erfahren, wie die einzelnen Teile des Projekts zusammenpassen. Wenn Sie beim Durcharbeiten des Tutorials auf Probleme stoßen, machen Sie sich Notizen – denn sicherzustellen, dass niemand anderes das gleiche Problem hat, ist ein großartiges Thema für einen ersten Beitrag!

Wenn Sie das Tutorial bis mindestens Schritt 4 abgeschlossen haben, fahren Sie mit der nächsten Frage fort.

1. Welche Computerausrüstung haben Sie dabei?

Die Geräte, die Sie zur Verfügung haben, schränken Ihre Möglichkeiten ein. Wenn Sie beispielsweise einen Windows-Laptop besitzen, können Sie keine Arbeiten im Zusammenhang mit iOS durchführen. Läuft Ihr Laptop unter Windows, macOS, Linux oder einem anderen Betriebssystem? Ist Ihr Smartphone ein iOS- oder Android-Gerät? Wurden Ihnen Ihre Geräte von Ihrem Arbeitgeber zur Verfügung gestellt oder sind es Ihre privaten Geräte?

1. Wie viel Erfahrung haben Sie mit dem Schreiben von Python-Code?

Sind Sie neu in der Programmierung? Ein Python-Veteran? Ein erfahrener Programmierer, der gerade erst angefangen hat, Python zu lernen? Ein frischgebackener Absolvent eines Bootcamp-Programms? Wir möchten ein Problem finden, das gut zu Ihrem Erfahrungsniveau passt.

1. Sind Sie mit den Beitragsprozessen bei GitHub vertraut?

Verwenden Sie GitHub (oder eine ähnliche Website zum Teilen von Code), um Ihren eigenen Code zu hosten oder zu Projekten anderer beizutragen? Wissen Sie, was CI (Continuous Integration) ist? Haben Sie schon einmal zu einem Projekt beigetragen, das Pre-Commit-Hooks verwendet? Wenn ich Sie bitten würde, „rebase Ihren PR gegen main“, wüssten Sie dann, was zu tun ist?

1. Haben Sie schon einmal zu einem Open-Source-Projekt beigetragen?

Haben Sie schon einmal an einem Sprint teilgenommen? Haben Sie schon einmal einen PR (Pull Request) für ein Open-Source-Projekt eingereicht? Sind Sie mit der Verwendung von GitHub zum Erstellen eines Pull Requests vertraut?

1. Haben Sie noch andere besondere Fähigkeiten, die nützlich sein könnten?

Sind Sie mit einer GUI-API (wie WinForms, Cocoa oder GTK) vertraut? Verfügen Sie über fundierte Kenntnisse der Interna eines bestimmten Betriebssystems? Sind Sie Experte in einer anderen Programmiersprache als Python? Wenn Sie keine besonderen Fähigkeiten haben, ist das kein Problem – aber wenn wir einen Windows-Guru in unseren Reihen haben, möchten wir sicherstellen, dass diese Fähigkeiten auch sinnvoll eingesetzt werden.

1. Warum sind Sie zu uns gekommen und woran sind Sie interessiert?

„Sie klangen wie ein sympathisches Projekt“ ist eine völlig ausreichende Antwort. Wenn es jedoch noch weitere Gründe gibt, warum Sie sich heute bei uns beworben haben, teilen Sie uns diese bitte mit. Interessieren Sie sich für die Entwicklung von Mobil- oder Desktop-Anwendungen? Für Packaging? Websites? Konsolenanwendungen? Wenn Sie kein spezielles Interesse haben – was erscheint Ihnen nach dem, was Sie bisher über BeeWare gesehen haben, am interessantesten?

Suchen Sie sich nun ein Mitglied des Bienenteams, das Ihre Antworten weitergibt. Sie stellen vielleicht Folgefragen stellen, aber dann wird man Sie auf einen Bereich hinweisen, in dem einen Bereich, in dem Sie einen Beitrag leisten können.

Finden Sie Ihr Thema

Wenn Sie mit einem Mitglied des Bee-Teams gesprochen haben, hat es Ihnen wahrscheinlich einen Teil des BeeWare-Projekts genannt, zu dem Sie beitragen können; möglicherweise hat es Ihnen sogar ein bestimmtes Problem vorgeschlagen, an dem Sie arbeiten können. Wenn es Ihnen kein konkretes Problem genannt hat, hat es Ihnen wahrscheinlich die „Good First Issues” für dieses Projekt genannt. Was bedeutet das?

GitHub bietet eine Liste von Problemen, die es BeeWare (und anderen Projekten) ermöglicht, alle gemeldeten Probleme zu verfolgen - Dazu gehören explizite Fehler, unerwartetes Verhalten, das möglicherweise ein Fehler ist, Anfragen für neue Funktionen, Anfragen für mehr Dokumentation - alles alles, was BeeWare verbessern könnte. Wenn neue Probleme gemeldet werden werden, wird das Bee Team einige von ihnen als Probleme kennzeichnen, die gut für die sich gut für einen Erstautor eignen - Probleme, die keine sofortige Behebung erfordern, aber gut definiert oder leicht reproduzierbar sind, und wahrscheinlich einen guten Hinweis auf die zugrunde liegende Ursache haben. Diese Probleme werden als "gutes erstes Problem" gekennzeichnet, damit sie leichter zu finden sind.

Um eine GitHub-Issue-Liste nach dem Label „good first issue“ zu filtern, gehen Sie wie folgt vor:

1. Klicken Sie auf die Schaltfläche „Labels“ über der Liste der Probleme, um das Dropdown-Menü zu aktivieren.
2. Geben Sie das Wort „gut“ in das Suchfeld oben im Dropdown-Menü ein.
3. Klicken Sie in der gefilterten Liste auf „gute erste Ausgabe“.

GitHub-Issues nach dem Label „Good First Issue“ filtern.

Wenn Sie ein interessantes Thema gefunden haben, lesen Sie alle Kommentare zu dem Beitrag und schreiben Sie einen Kommentar in die Diskussion, dass Sie dass Sie sich das Problem ansehen (z.B. "Ich sehe mir das bei den PyCon US 2025 Sprints"). BeeWare "weist" nicht explizit Themen zu - wir akzeptieren Beiträge von jedem. In einer Sprint-Situation müssen wir jedoch müssen wir jedoch sicherstellen, dass nicht zwei Leute am selben Thema arbeiten Thema arbeiten - das Hinterlassen eines Kommentars ist ein leichtes Mittel, um sich zwischen Mitwirkenden.

Wenn Sie immer noch nichts finden, was Sie gerne tun würden, suchen Sie ein Mitglied des Bee Teams Mitglied, das Ihnen helfen wird, ein bestimmtes Thema einzugrenzen.

Entwicklungsumgebung einrichten

Wenn Sie ein Problem gefunden haben, müssen Sie Ihre Entwicklungsumgebung so einrichten Umgebung einrichten, damit Sie an einer Lösung arbeiten können. Jedes BeeWare-Projekt hat seine eigene Anleitung zur Mitarbeit:

• Briefcase
• Toga
• Rubicon ObjC

Wenn das Projekt nicht in dieser Liste aufgeführt ist, finden Sie in der README-Datei des Projekts Einzelheiten wie Sie es einrichten können. Wenn eine der Anweisungen keinen Sinn ergibt (oder Sie diese Anweisungen nicht finden können, wenden Sie sich an ein Mitglied des Bee-Teams, und und sie werden dir helfen, das Problem zu lösen. Und - wenn du denkst, dass du die Anleitung verbessern kannst Anleitungen verbessern können, damit andere Leute nicht auf das gleiche Problem stoßen, ist die Verbesserung der Anleitung zu verbessern, ist ein wertvoller Beitrag!

Jetzt können Sie mit der Arbeit an Ihrem Problem beginnen!

Was passiert, nachdem ich meinen PR eingereicht habe?

Sobald Sie Ihren Pull-Antrag eingereicht haben und dieser alle automatischen alle automatischen Prüfungen bestanden hat, sind Sie bereit für eine Überprüfung. Teilen Sie einem Mitglied des Kernteams Team wissen, dass Sie einen PR zur Überprüfung bereit haben, und sie werden einen ansehen.

Wenn es sich um Ihre erste PR handelt, ist es sehr wahrscheinlich, dass die Überprüfung einige Probleme finden. Es könnte sich dabei um einen Randfall handeln, den Sie nicht bedacht haben, oder um eine Code Konvention, die Sie nicht beachtet haben. Lassen Sie sich nicht entmutigen! Niemand - nicht einmal selbst das Kernteam - schafft es, dass PRs beim ersten Versuch zu 100% korrekt sind.

Sobald die PR die Überprüfung bestanden hat, wird Ihr Prüfer die PR zusammenführen – und schon sind Sie fertig! Herzlichen Glückwunsch – Sie haben einen Beitrag zu BeeWare geleistet! Wenn dies Ihr allererster Beitrag zu BeeWare ist, haben Sie sich auch Ihre BeeWare Challenge Coin verdient – suchen Sie ein Mitglied des Kernteams auf, das Ihnen eine Münze geben wird!

Hilfe! Ich stecke fest!

Wenn Sie an irgendeinem Punkt des Weges nicht weiterkommen, wenden Sie sich an ein Mitglied des Bee Teams. Scheuen Sie sich nicht, jede Frage zu stellen. Wenn Sie nicht weiterkommen, wollen wir Sie aus der Klemme helfen. Wenn Sie verwirrt sind, liegt das daran, dass das Thema kompliziert ist kompliziert ist, und wir haben es nicht gut genug erklärt. Wir sind begierig darauf helfen - und wir wollen sicherstellen, dass Sie einen erfolgreichen Sprint haben.

Was passiert, wenn ich meinen Beitrag während des Sprints nicht fertigstelle?

Kein Problem! Sie können jederzeit einen Beitrag einreichen. Ein Ziel der Sprints ist es, Sie zu ermutigen und zu befähigen, auch im weiteren Verlauf des Jahres Beiträge zu leisten. Das Bee-Team steht Ihnen bei jedem Schritt dieses Prozesses zur Seite.

Wenn Sie bereits an einem GitHub-Issue gearbeitet oder einen PR eingereicht haben, können Sie weiterhin über GitHub kommunizieren. Wenn Sie weitere Fragen haben oder Hilfe in Echtzeit benötigen, finden Sie uns am besten auf dem BeeWare Discord-Server. Wir freuen uns auf die weitere Zusammenarbeit mit Ihnen!

Verbesserung dieses Leitfadens

Wenn Sie Vorschläge haben, wie wir diesen Sprint-Leitfaden verbessern können, lassen Sie es uns wissen. Was hat bei Ihnen funktioniert? Was hat nicht geklappt? Was können wir besser machen? Und denken Sie daran: Die Behebung eines Problem mit diesem Sprint Guide zählt als Beitrag zu BeeWare!