Velkommen til BeeWare Sprints!
Velkommen til! Vi er så glade for, at du har besluttet at slutte dig til os! Hvis du ikke allerede har allerede har præsenteret dig for en fra Bee Team, så gør det. Når du har gjort det, kan du gå tilbage hertil for at komme i gang.
Hvad er et sprint?
Et sprint er en ustruktureret mulighed for at bruge et par timer eller dage på at samarbejde om et open source-projekt. De er ofte knyttet til en konference; et sprint efter en konference giver mulighed for at at omsætte den energi, entusiasme og interesse, som en konference har skabt til forbedringer af den software, vi bruger til daglig.
Sprints er også en mulighed for at introducere folk til processen med at bidrage til projektet. Vores håb er, at du vil have det så sjovt at bidrage under sprinten, at du tager hjem og bliver ved med at bidrage!
[Det er ligegyldigt, hvor meget erfaring du har har] (/bidrager/første gang/imposter-syndrom/). På tidligere sprints, har vi fusioneret bidrag fra folk på alle niveauer af erfaring - gymnasieelever, nyuddannede fra bootcamp, folk, der ikke betragter ikke betragter sig selv som programmører, og erfarne udviklere. Uanset dit erfaringsniveau - vi kan finde en måde, hvorpå du kan bidrage.
Kode er heller ikke den eneste måde, du kan bidrage på. Et projekt som BeeWare er meget mere end bare koden - vi har brug for folk til at skrive, korrekturlæse og oversætte dokumentation; vi har brug for folk til at forbedre design af websider; selv processen med at gennemgå fejl, der blev rapporteret for mange år siden og konstatere, at de er blevet rettet undervejs er et værdifuldt bidrag.
De indledende spørgsmål
For at få dig i gang vil vi stille et par spørgsmål, så vi kan måle dine interesser og erfaringer. Det vil hjælpe os med at finde den bedste måde du kan bidrage. Arbejd dig igennem spørgsmålene, tag noter, og find så et medlem af Bee Team og del dine svar. Hvis du ikke forstår det spørgsmål, der bliver stillet - så tænk ikke på det! Fortæl os, hvad du ved, og så arbejder vi sammen om at finde ud af det derfra.
**Har du brugt BeeWare før?
Hvis du ikke har gjort det, så start med at arbejde dig igennem [BeeWare Tutorial] (https://docs.beeware.org/en/latest/). Den vil give dig en introduktion til, hvad BeeWare-projektet er, og hvordan delene af projektet passer sammen. Hvis du får problemer med at tage noter - for at sikre, at ingen andre har det samme problem, er problem er et godt emne for et første bidrag!
Når du er færdig med vejledningen til mindst trin 4, kan du gå videre til det næste spørgsmål.
Hvilket computerudstyr har du med dig?
Det udstyr, du har med dig, sætter praktiske grænser for, hvad du kan bidrage med. Hvis du for eksempel har en Windows-laptop, vil du vil du ikke kunne arbejde på noget, der har med iOS at gøre. Kører din laptop Windows, macOS, Linux eller noget andet? Er din telefon en iOS- eller Android-enhed? Har du fået dine enheder stillet til rådighed af din arbejdsgiver, eller er det dine egne personlige enheder?
Hvor meget erfaring har du med at skrive Python-kode?
Er du ny i programmering? En Python-veteran? En kodningsveteran, der kun lige er begyndt at lære Python? En nyuddannet fra et bootcamp-program? Vi vil gerne finde et problem, der er et godt match til dit erfaringsniveau.
**Er du bekendt med Githubs bidragsprocesser?
Bruger du GitHub (eller et lignende site til deling af kode) til at hoste din egen kode eller til at bidrage til andres projekter? Ved du, hvad CI (kontinuerlig integration) er? Har du bidraget til et projekt, der har pre-commit hooks? Hvis jeg bad dig om at "rebase din PR mod main", ville du så vide, hvad du skulle gøre?
**Har du bidraget til et open source-projekt før?
Har du tidligere deltaget i et sprint? Har du nogensinde indsendt en PR (pull request) til et Open Source-projekt? Er du bekendt med, hvordan hvordan man bruger Github til at oprette en pull request?
**Har du andre særlige færdigheder, som kan være nyttige?
Er du fortrolig med et GUI API (såsom Winforms, Cocoa eller GTK)? Har du dyb viden om de interne forhold i et bestemt operativsystem? Er du ekspert i et andet programmeringssprog end Python? Hvis du ikke har nogen særlige færdigheder, er det ikke et problem - men hvis vi har en Windows-guru på hånden, vil vi gerne sikre os, at de færdigheder bliver brugt godt.
Hvorfor kom du til os, og hvad er du interesseret i?
"Du lød som et venligt projekt" er et helt fint svar. Men hvis der er flere grunde til, at du kom til os i dag, så lad os det vide. Er du interesseret i mobil- eller desktopudvikling? Emballage? Hjemmesider? Konsol-apps? Hvis du ikke har en specifik interesse - hvad mest interessant ud fra det, du har set om BeeWare indtil videre? indtil videre?
Find nu et medlem af bi-teamet, som du kan dele dine svar med. De vil måske stille nogle opfølgende spørgsmål; men så vil de pege dig i retning af et område et område, hvor du bør kunne yde et bidrag.
Find dit problem
Hvis du har talt med et medlem af Bee Team, har de sikkert peget på en del af dig til en del af BeeWare-projektet, hvor du kan bidrage. måske har de endda foreslået et specifikt problem at arbejde på. Hvis de ikke har givet dig et specifikt emne, har de sandsynligvis henvist dig til "Good First Issues" for det pågældende projekt. Hvad betyder det?
GitHub indeholder en liste over problemer, som gør det muligt for BeeWare (og andre projekter) at holde styr på alle de problemer, der er blevet rapporteret - det det inkluderer eksplicitte fejl, uventet opførsel, der måske er en fejl, anmodninger om nye funktioner, anmodninger om mere dokumentation - alt der kan være en måde, hvorpå BeeWare kan forbedres. Efterhånden som nye problemer rapporteres, vil Bee Team markere nogle af dem som problemer, der er velegnede til en førstegangsbidragsyder - problemer, der ikke kræver en umiddelbar løsning, men som er veldefinerede eller lette at reproducere, og som sandsynligvis har et godt bud på den underliggende årsag. Disse problemer er mærket "godt første problem" for at gøre dem lettere at finde.
Hvis du vil filtrere en GitHub-problemliste efter etiketten "godt første problem", skal du følge disse trin:
- Klik på knappen "Etiketter" over listen med emner for at aktivere for at aktivere rullemenuen.
- Skriv ordet "good" i søgefeltet øverst i drop-down-menuen. menuen.
- Klik på "good first issue" i den filtrerede liste.
.
Når du har fundet et emne, der ser interessant ud, skal du læse alle kommentarer til indlægget, og skriv en kommentar i diskussionen om, at du at du undersøger problemet (f.eks. "Undersøger dette ved PyCon US 2025 sprints"). BeeWare "tildeler" ikke eksplicit problemer - vi accepterer bidrag fra hvem som helst. Men i en sprintsituation er vi nødt til at sørge for, at vi ikke ender med to personer, der arbejder på det samme problem - at efterlade en kommentar er en let måde at koordinere mellem bidragydere.
Hvis du stadig ikke kan finde noget, du gerne vil gøre, kan du finde et Bee Team medlem, og de vil hjælpe dig med at indkredse et specifikt problem.
Sæt et udviklingsmiljø op
Når du har fundet et problem, skal du sætte dit udviklingsmiljø op, så du kan arbejde på en løsning. miljø, så du kan arbejde på en løsning. Hvert BeeWare-projekt har sin egen bidragsguide:
Hvis projektet ikke er på denne liste, skal du tjekke projektets README for detaljer om, hvordan man kommer i gang. Hvis nogle af instruktionerne ikke giver mening (eller du ikke kan finde instruktionerne), så find et medlem af Bee Team, og de vil hjælpe dig videre. Og - hvis du mener, at du kan forbedre instruktionerne, så andre ikke får samme problem, er det et værdifuldt bidrag at forbedre bidragsguiden er et værdifuldt bidrag!
Nu kan du begynde at arbejde på dit problem!
Hvad sker der, når jeg har indsendt min PR?
Når du har indsendt din pull-anmodning, og pull-anmodningen har bestået alle de automatiserede tjek, er du klar til en gennemgang. Fortæl en fra kerneteamet team, at du har en PR klar til gennemgang, så kigger de på den. kigger på den.
Hvis det er din første PR, er det meget sandsynligt, at gennemgangen vil finde nogle problemer. Det kan være en edge case, du ikke har overvejet, eller en kodekonvention konvention, som du ikke har fulgt. Lad dig ikke afskrække! Ingen - ikke engang ikke engang kerneteamet - får PR'er 100% korrekte i første forsøg.
Når PR'en er godkendt, vil din reviewer flette PR'en sammen - og så er du færdig! Tillykke - du har bidraget til BeeWare! Hvis dette er dit allerførste BeeWare-bidrag, har du også optjent din [BeeWare Challenge Coin] (/contributing/challenge-coins) - find et medlem af kerneteamet, og de vil give dig en mønt!
Hjælp! Jeg sidder fast!
Hvis du går i stå på et tidspunkt undervejs, så find et medlem af Bee holdet. Vær ikke bange for at stille et hvilket som helst spørgsmål. Hvis du sidder fast, vil vi gerne få dig ud af det. Hvis du er forvirret, er det fordi emnet er kompliceret, og vi har ikke forklaret det godt nok. Vi er ivrige efter at hjælpe - og vi vil sikre, at du får et vellykket sprint.
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!