Hvad skal jeg gøre?

Det bedste sted at starte med et open source-bidrag er med noget, der passer til din viden, erfaring og interesseområde.

Før du begynder

Før du begynder at bidrage, kan det hjælpe at få en fornemmelse af projektet som helhed. Hvis du ikke allerede har gennemgået [BeeWare Tutorial] (https://docs.beeware.org), så start der. Det vil give dig til de vigtigste BeeWare-værktøjer, så du kan se, hvordan de alle passer sammen.

Når du har gennemført denne vejledning, er du klar til at vælge noget at arbejde videre med. Hvis du havde problemer med at udføre vejledningen - hvis du stødte på en fejl, eller hvis sproget, der blev brugt til at beskrive et trin, ikke var klart - så er det et godt sted at starte! Hvis du kan omsætte din oplevelse til en forbedring af vejledningen, vil den næste person, der laver vejledningen, ikke ikke det samme problem.

Men hvis din tutorial-oplevelse var helt problemfri (og det håber vi det var!), er her nogle ideer til, hvor du kan engagere dig, afhængigt af dine færdigheder og interesser.

Python-programmering

Kuffert

Hvis du gerne vil bidrage til et værktøj, der har et klart defineret problem men som har brug for at få fjernet fejl og tilføjet funktioner, kan [Briefcase] (https://github.com/beeware/briefcase) være projektet for dig. dig. Briefcase er et værktøj til at pakke et Python-projekt som en selvstændig GUI-applikation. Det tager en pyproject.toml-konfigurationsfil og bruger disse konfigurationsdata til at generere installationsprogrammer eller applikationsbundter.

The Briefcase [udgave tracker] (https://github.com/beeware/briefcase/issues) har en samling af forslag til funktioner (og et mindre antal fejl). Hvis dette er din første gang, du bidrager, skal du kigge efter en af de tickets, der er mærket good første issue - Det er numre, der er udvalgt specifikt til førstegangsbidragsydere bidragsydere, fordi de burde være relativt enkle at implementere. Det kan også være nyttigt at filtrere billetterne efter den platform, du rent faktisk bruger til udvikling - det vil være svært at rette en en Linux-fejl, hvis du ikke har en Linux-maskine, du kan bruge til at teste på!

Hvis du gerne vil bidrage til et bestemt projekt, kan du også filtrere gode første spørgsmål efter specifikke projekter ved hjælp af disse links:

Vælg en ticket, skriv en kommentar om, at du undersøger problemet, og prøv at udvikle en pull request, der implementerer en løsning!

GUI-programmering

Hvis du har erfaring med et indbygget widget-bibliotek - Cocoa på macOS, GTK+ på Linux, Windows Forms eller de oprindelige iOS- eller Android-biblioteker, kan du måske hjælpe med [Toga] (https://github.com/beeware/toga). Toga er et widget-værktøjssæt på tværs af platforme - det giver en fælles grænseflade for brugergrænsefladeelementer som knapper og træer.

Toga har allerede defineret en række grænseflader, men implementeringen af implementeringen af disse grænseflader er dog ikke komplet på alle platforme. Vælg en widget, og implementer den til den platform, du vælger!

Selv hvis du ikke kender et indbygget widgetbibliotek, kan du måske stadig hjælpe med Toga. At skrive nye widgets er meget mindre kompliceret, end det det måske ser ud til. Hver platform har dokumentation for, hvordan man bruger deres indbyggede API'er, og processen med at oversætte denne platformsdokumentation fra et andet sprog (f.eks. Objective C eller C#) er en relativt ligetil proces. Den eksisterende kode bør give dig nogle tips hvordan det kan gøres, og BeeWare-teamet hjælper gerne, hvis du har brug for det. brug for det. Hop på [BeeWare Discord] (/bee/chat/), så gør vi, hvad vi kan for at hjælpe! hvad vi kan for at hjælpe!

Even if you're not up for transforming code from one language to another, Toga's core library — as well as Travertino, a subpackage covering styling and layout — are pure Python, and platform-agnostic. Take a look at issues not tagged with a specific platform — many of them can probably be fixed with little or no change to any platform-specific code.

Dokumentation

God dokumentation er afgørende for ethvert vellykket projekt. Vi ved, at Toga og Briefcase begge har brug for betydelige forbedringer af deres dokumentation. Du har gennemgået vejledningen; tag nu se på dokumentationen for Toga og [Briefcase Briefcase og se, om du kan finde en måde at forbedre de tutorials, referencer og emnevejledninger, der er der.

Vejledninger

En af de bedste måder at bidrage på er at sørge for, at vores introduktions- og vejledningsdokumentation er bundsolid. Vælg et projekt af interesse fra BeeWare-pakken, og prøv at følge vejledningen til at komme i gang og vejledningen. Hvis du ikke kan finde startvejledningen - så er det den første ting, du skal rapportere!

Mens du arbejder dig gennem vejledningen, skal du notere dig alt, hvad der ikke giver mening eller ikke virker. Åbn derefter en fejlrapport for disse problemer.

Windows

Hvis du er Windows-bruger, kan BeeWare bestemt bruge din hjælp. Kerneteamet kerneholdet bruger alle Linux og macOS i deres daglige udvikling, og derfor derfor er det meget nemt at få inkompatibilitet med Windows. Dette skyldes næsten altid en forglemmelse. At identificere - og måske endda løse - problemer med at køre BeeWare-værktøjer på Windows er en enorm hjælp.

Sprog

Taler du et andet sprog end engelsk? På nuværende tidspunkt har kerneteamet har alle engelsk som modersmål. At levere oversættelser af dokumentation eller helt nye tutorials eller vejledninger på dit modersmål sprog er en god måde at bidrage på. Vælg et projekt, der allerede har dokumentation, og oversæt den tekst. Alternativt kan du starte helt fra bunden og skriv en helt ny vejledning.

Hvis du taler et sprog med et ikke-latinsk tegnsæt (f.eks. russisk eller kinesisk) eller et sprog med højre-venstre-skrift (f.eks. hebraisk eller arabisk), vil du kunne udpege alle de steder, hvor vi har antaget simpel ASCII-kodning eller venstre-til-højre-konventioner. Vælg et hvilket som helst af de aktive BeeWare-projekter, og prøv at bruge det med dit modersmål. sprog. Hvis du støder på problemer, så rapporter dem som bugs; hvis du føler dig særligt eventyrlysten, så se, om du kan finde ud af at fikser fejlen også.

Praktisk brug

En af de bedste måder for os at finde ud af, hvor vores huller er - i både dokumentation og API'er - er, at folk rent faktisk bruger BeeWare til at bygge noget. Så hvis ingen af de hidtidige ideer lyder interessante, hvorfor så ikke prøve noget af dit eget? Brug BeeWare-pakken til at bygge den app du altid har ønsket dig - en desktop-visualisering af en datakilde eller en mobilapplikation til at spore dine aktiviteter - hvad det end er, så prøv at bygge den.

Vi kan næsten garantere, at du vil støde på problemer. BeeWare er stadig et meget ungt projekt. Men de problemer, du støder på, vil give os en god indikation af, hvad der skal tages fat på. Det vil indikere, hvilke widgets vi har brug for, og hvilken dokumentation der skal forbedres. Så når du støder på problemer med at bygge din egen app, så log problemer med de BeeWare-projekter der forårsagede problemerne. Det vil gøre det muligt for os at identificere, hvad vi skal forbedre - og det kan endda være en kilde til inspiration for dig til at bidrage!