Am besten fangen Sie mit einem Open-Source-Beitrag an, wenn Sie etwas, das Ihrem Wissen, Ihrer Erfahrung und Ihrem Interessengebiet entspricht.
Bevor Sie beginnen
Bevor Sie mit der Mitarbeit beginnen, sollten Sie sich ein Bild von dem Projekt als Ganzes zu bekommen. Wenn Sie nicht bereits das [BeeWare Tutorial] (https://docs.beeware.org) gelesen haben, fangen Sie dort an. Dies wird Ihnen die die wichtigsten BeeWare-Werkzeuge kennen, so dass Sie sehen können, wie sie alle zusammenpassen.
Sobald Sie dieses Tutorial abgeschlossen haben, können Sie sich etwas aussuchen zu arbeiten. Wenn Sie Probleme hatten, das Tutorial zu bearbeiten - wenn Sie auf einen Fehler gefunden haben, oder wenn die Beschreibung eines Schrittes nicht klar war - das ist ein ein guter Anfang! Wenn Sie Ihre Erfahrungen in eine Verbesserung Verbesserung des Tutoriums umwandeln können, wird die nächste Person, die das Tutorium bearbeitet auf das gleiche Problem stoßen.
Wenn Ihr Tutorium jedoch völlig reibungslos verlaufen ist (und wir hoffen (und wir hoffen, dass es das war!), finden Sie hier einige Ideen, wo Sie sich je nach Ihren Fähigkeiten und Interessen.
Python-Programmierung
Aktentasche
Wenn Sie zu einem Tool beitragen möchten, das ein klar definiertes Problem hat
Problemstellung hat, aber Fehler beseitigt und Funktionen hinzugefügt werden müssen,
ist [Briefcase] (https://github.com/beeware/briefcase) vielleicht das richtige Projekt für
für Sie sein. Briefcase ist ein Werkzeug zum Verpacken eines Python-Projekts als eigenständige
GUI-Anwendung. Es nimmt eine Konfigurationsdatei pyproject.toml
und
verwendet diese Konfigurationsdaten, um Installationsprogramme oder verteilbare
Anwendungspakete.
The Briefcase [Ausgabe tracker] (https://github.com/beeware/briefcase/issues) hat eine Sammlung von Funktionsvorschlägen (und eine kleinere Anzahl von Fehlern). Wenn dies Ihr zum ersten Mal einen Beitrag leisten, suchen Sie nach einem der Tickets mit der Bezeichnung good erste issue - Dies sind Themen, die speziell für Erstautoren ausgewählt wurden ausgewählt wurden, weil sie relativ einfach zu implementieren sein umzusetzen. Sie könnten es auch hilfreich finden, die Tickets nach der Plattform zu filtern Plattform zu filtern, auf der Sie tatsächlich entwickeln - es wird schwierig sein, einen einen Linux-Fehler zu beheben, wenn Sie keinen Linux-Rechner zum Testen haben!
Wenn Sie zu einem bestimmten Projekt beitragen möchten, können Sie auch über diese Links gute erste Ausgaben nach bestimmten Projekten filtern:
Wählen Sie ein Ticket aus, hinterlassen Sie einen Kommentar, dass Sie sich das Problem ansehen, und versuchen Sie, einen Pull-Request zu entwickeln, der eine Lösung implementiert!
GUI-Programmierung
Wenn Sie Erfahrung mit einer nativen Widget-Bibliothek haben - Cocoa auf macOS, GTK+ auf Linux, Windows Forms, oder die nativen iOS oder Android Bibliotheken, können Sie vielleicht bei Toga helfen. Toga ist ein plattformübergreifendes Widget-Toolkit - es bietet eine gemeinsame Schnittstelle für Benutzeroberflächenelemente wie Schaltflächen und Bäume.
Toga hat bereits eine Reihe von Schnittstellen definiert; allerdings ist die Implementierung dieser Schnittstellen ist jedoch nicht für alle Plattformen vollständig. Wählen Sie ein Widget und implementieren Sie dieses Widget für die Plattform Ihrer Wahl!
Selbst wenn Sie keine native Widget-Bibliothek kennen, können Sie vielleicht trotzdem mit Toga zu helfen. Das Schreiben neuer Widgets ist viel weniger kompliziert, als es erscheinen mag. Jede Plattform hat eine Dokumentation, wie man ihre nativen APIs, und der Prozess der Übersetzung dieser Plattform-Dokumentation aus einer einer anderen Sprache (z.B. Objective C oder C#) ist ein relativ unkomplizierter Prozess. Der vorhandene Code sollte Ihnen einige Anhaltspunkte geben geben, und das BeeWare-Team hilft Ihnen gerne, wenn Sie Hilfe brauchen. Besuchen Sie den BeeWare Discord und wir werden alles tun wir können helfen!
Wenn Sie keine Lust haben, den Code von einer Sprache in eine andere umzuwandeln - gibt es immer noch die Test-Suite. Die Kernbibliothek von Toga hat auch ein Testpaket Suite, aber die Abdeckung dieser Testsuite ist nicht sehr gut. Wählen Sie eine Widget-Schnittstelle aus und schauen Sie, ob Sie einen Test dafür schreiben können!
Dokumentation
Eine gute Dokumentation ist für jedes erfolgreiche Projekt unerlässlich. Wir wissen, dass Toga und Briefcase beide erhebliche Verbesserungen an ihrer Dokumentation benötigen. Sie haben das Tutorium durchlaufen; jetzt werfen Sie einen Blick auf die Dokumentation von Toga und Briefcase an und schauen Sie, ob Sie einen Weg finden Weg finden, die Tutorials, Referenzen und Themenhandbücher zu verbessern, die vorhanden sind.
Tutorials
Eine der besten Möglichkeiten, einen Beitrag zu leisten, besteht darin, dafür zu sorgen, dass unsere Einführungs- und Tutorial-Dokumentation felsenfest ist. Wählen Sie ein Projekt von Interesse aus der BeeWare-Suite und versuchen Sie, die Einführungsanleitung und das Tutorial zu folgen. Wenn Sie die Einführungsanleitung nicht finden können - dann ist das das erste, was Sie melden sollten!
Wenn Sie die Anleitung durcharbeiten, notieren Sie sich alles, was nicht Sinn macht oder nicht funktioniert. Eröffnen Sie dann einen Fehlerbericht für diese Probleme.
Fenster
Wenn Sie ein Windows-Benutzer sind, kann BeeWare Ihre Hilfe definitiv gebrauchen. Das Kernteam benutzt Linux und macOS in der täglichen Entwicklung, was dazu führt können sich Windows-Inkompatibilitäten sehr leicht einschleichen. Diese ist fast immer auf ein Versehen zurückzuführen. Das Erkennen - und vielleicht sogar Probleme bei der Ausführung von BeeWare-Tools unter Windows zu erkennen - und vielleicht sogar zu beheben - ist eine immense Hilfe.
Sprachen
Sprechen Sie eine andere Sprache als Englisch? Gegenwärtig ist das Kernteam sind alle englische Muttersprachler. Die Bereitstellung von Übersetzungen der Dokumentation oder komplett neue Tutorials oder Anleitungen in Ihrer Muttersprache Sprache ist eine gute Möglichkeit, einen Beitrag zu leisten. Wählen Sie ein Projekt, das bereits eine Dokumentation hat, und übersetzen Sie diesen Text. Oder Sie fangen von vorne an und schreiben Sie eine komplett neue Anleitung.
Wenn Sie eine Sprache mit einem nicht-lateinischen Zeichensatz sprechen (z. B. Russisch oder Chinesisch) oder eine Sprache mit einer Rechts-nach-Links-Schrift (z. B. Hebräisch oder Arabisch), werden Sie uns alle Stellen nennen können, an denen wir von einer einfache ASCII-Kodierung oder Links-nach-Rechts-Konventionen angenommen haben. Wählen Sie eines der aktiven BeeWare-Projekte und versuchen Sie, es in Ihrer Muttersprache zu verwenden. Sprache. Wenn Sie auf Probleme stoßen, melden Sie diese Probleme als Fehler; wenn Sie besonders abenteuerlustig sind, versuchen Sie herauszufinden, wie man den Fehler auch beheben können.
Praktische Anwendung
Eine der besten Möglichkeiten für uns, um festzustellen, wo unsere Lücken sind - sowohl in der Dokumentation und APIs - ist, wenn die Leute BeeWare tatsächlich benutzen, um etwas zu etwas zu bauen. Wenn also keine der bisherigen Ideen interessant klingt, warum nicht etwas Eigenes ausprobieren? Verwenden Sie die BeeWare-Suite, um die Anwendung zu erstellen die Sie schon immer haben wollten - eine Desktop-Visualisierung einer Datenquelle oder eine mobile Anwendung zur Verfolgung Ihrer Aktivitäten - was immer es ist, versuchen Sie es es zu bauen.
Wir können fast garantieren, dass Sie auf Probleme stoßen werden. BeeWare ist ein noch sehr junges Projekt. Aber die Probleme, auf die Sie stoßen, geben uns einen guten Hinweis darauf, was in Angriff genommen werden muss. Es wird zeigen, welche Widgets wir wir brauchen, und welche Dokumentation verbessert werden muss. Wenn Sie also auf Probleme beim Erstellen Ihrer eigenen Anwendung haben, protokollieren Sie die Probleme mit den BeeWare-Projekten die Probleme verursacht haben. So können wir feststellen, was wir verbessern müssen verbessern müssen - und es könnte sogar eine Quelle der Inspiration für Sie sein beizutragen!