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 hat] (/Beitrag/Erstling/Imposter-Syndrom/). Bei vergangenen Sprints, haben wir Beiträge von Leuten mit unterschiedlichem Erfahrungsstand zusammengeführt - Schüler, Absolventen eines Bootcamps, Leute, die sich nicht als sich nicht als Programmierer sehen, und erfahrene Entwickler. Unabhängig von Ihrem Erfahrungsstand - wir finden einen Weg für Sie, einen Beitrag zu leisten.
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.
Haben Sie BeeWare schon einmal benutzt?
Wenn Sie dies noch nicht getan haben, beginnen Sie mit dem [BeeWare Tutorial] (https://docs.beeware.org/en/latest/). Es wird Ihnen eine Einführung in das BeeWare-Projekt und wie die Teile des Projekts des Projekts zusammenpassen. Wenn Sie beim Durcharbeiten des Tutorials auf Probleme stoßen Tutorials auf Probleme stoßen, machen Sie sich Notizen - denn um sicherzustellen, dass kein anderer Problem hat, ist ein tolles Thema für einen ersten Beitrag!
Wenn Sie das Lernprogramm mindestens bis Schritt 4 abgeschlossen haben, gehen Sie weiter zur der nächsten Frage.
Welche Computerausrüstung haben Sie dabei?
Die Ausrüstung, die Sie bei sich haben, setzt dem, was Sie tun können, praktische Grenzen. zu dem Sie beitragen können. Wenn Sie zum Beispiel einen Windows-Laptop haben, können Sie können Sie nicht an etwas arbeiten, das mit iOS zu tun hat. Läuft Ihr Laptop mit Windows, macOS, Linux oder etwas anderem? Ist Ihr Telefon ein iOS- oder Android-Gerät? Wurden Ihre Geräte von Ihrem Arbeitgeber zur Verfügung gestellt, oder sind es Ihre eigenen Geräte?
Wie viel Erfahrung haben Sie beim Schreiben von Python-Code?
Sind Sie neu in der Programmierung? Ein Python-Veteran? Ein Programmierer-Veteran, der der gerade erst angefangen hat, Python zu lernen? Ein frischer Absolvent eines Bootcamp-Programm? Wir möchten ein Problem finden, das gut zu Ihrem Ihr Erfahrungsniveau passt.
Sind Sie mit den Github-Beitragsprozessen vertraut?
Verwenden Sie GitHub (oder eine ähnliche Code-Sharing-Website), um Ihren eigenen Code zu hosten oder zu den Projekten anderer beizutragen? Wissen Sie, was CI (kontinuierliche Integration) ist? Haben Sie zu einem Projekt beigetragen, das Pre-Commit-Hooks hat? Wenn ich Sie bitten würde, "Ihren PR gegen main", wüssten Sie, was zu tun ist?
Haben Sie schon einmal an einem Open-Source-Projekt mitgewirkt?
Haben Sie in der Vergangenheit an einem Sprint teilgenommen? Haben Sie jemals einen PR (Pull Request) bei einem Open-Source-Projekt eingereicht? Sind Sie damit vertraut, wie man wie man Github benutzt, um einen Pull Request zu erstellen?
Verfügen Sie über weitere besondere Fähigkeiten, die nützlich sein könnten?
Sind Sie mit einer GUI-API (wie Winforms, Cocoa oder GTK) vertraut? Haben Sie fundierte Kenntnisse über die Interna eines bestimmten Betriebssystems? Sind Sie ein Experte in einer anderen Programmiersprache als Python? Wenn Sie keine besonderen Fähigkeiten haben, ist das kein kein Problem - aber wenn wir einen Windows-Guru haben, wollen wir wollen wir sicherstellen, dass diese Fähigkeiten auch wirklich genutzt werden.
Warum sind Sie zu uns gekommen und was interessiert Sie?
"Sie klangen wie ein freundliches Projekt" ist eine sehr gute Antwort. Wenn es jedoch noch weitere Gründe gibt, warum Sie heute zu uns gekommen sind, lassen Sie es uns wissen. Interessieren Sie sich für mobile oder Desktop-Entwicklung? Verpackung? Websites? Konsolenanwendungen? Wenn Sie kein bestimmtes Interesse haben - was am interessantesten, basierend auf dem, was Sie bisher über BeeWare gesehen haben bisher gesehen haben?
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 Problem
Wenn Sie mit einem Mitglied des Bee-Teams gesprochen haben, hat man Sie wahrscheinlich auf einen Teil des BeeWare-Projekts hingewiesen, zu dem Sie beitragen können Vielleicht haben sie sogar ein bestimmtes Problem vorgeschlagen, an dem Sie arbeiten können. Wenn sie Ihnen kein kein bestimmtes Thema genannt hat, hat man Sie wahrscheinlich auf die "Good First Issues" für dieses Projekt hingewiesen. Was ist damit gemeint?
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 diese Schritte:
- Klicken Sie auf die Schaltfläche "Etiketten" oberhalb der Liste der Ausgaben, um das das Dropdown-Menü zu aktivieren.
- Geben Sie das Wort "gut" in das Suchfeld am oberen Rand des Dropdown-Menüs Menüs ein.
- Klicken Sie in der gefilterten Liste auf "gute Erstausgabe".
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.
Einrichten einer Entwicklungsumgebung
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:
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 der PR die Prüfung bestanden hat, wird Ihr Prüfer den PR zusammenführen - und Sie sind fertig! Herzlichen Glückwunsch - Sie haben einen Beitrag zu BeeWare geleistet! Wenn dies Ihr allererste BeeWare-Beitrag ist, haben Sie sich auch Ihre BeeWare Challenge Coin - suchen Sie ein Mitglied des Kernteams, und sie werden dir eine Münze geben!
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.
What if I don't complete my contribution during the sprint?
No problem! You can submit a contribution at any time. A goal of the sprints is to encourage and empower you to continue contributing throughout the rest of the year. The Bee Team are available to help with any part of this process.
If you were already working on a GitHub issue or submitted a PR, you can continue to communicate through GitHub. If you have other questions or need real-time help, the best place to find us is the BeeWare Discord server. We're looking forward to continuing to work with you!