Sprint-guide

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. I tidligere sprints har vi samlet bidrag fra mennesker med alle niveauer af erfaring – gymnasieelever, nyuddannede fra bootcamps, mennesker, der ikke betragter sig selv som programmører, og erfarne udviklere. Uanset dit erfaringsniveau kan vi 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.

1. Har du brugt BeeWare før?

Hvis du ikke har gjort det, så start med at gennemgå BeeWare Tutorial. Den giver dig en introduktion til, hvad BeeWare-projektet er, og hvordan projektets dele passer sammen. Hvis du støder på problemer undervejs i tutorialen, så tag noter – for at sikre, at ingen andre har det samme problem, er et godt emne for et første bidrag!

Når du har gennemført vejledningen mindst til trin 4, kan du gå videre til næste spørgsmål.

1. Hvilket computerudstyr har du med dig?

Det udstyr, du har med dig, sætter praktiske begrænsninger for, hvad du kan bidrage med. Hvis du f.eks. har en Windows-bærbar computer, kan du ikke arbejde med noget, der har med iOS at gøre. Kører din bærbare computer Windows, macOS, Linux eller noget andet? Er din telefon en iOS- eller Android-enhed? Er dine enheder leveret af din arbejdsgiver, eller er det dine egne personlige enheder?

1. Hvor meget erfaring har du med at skrive Python-kode?

Er du ny inden for programmering? En Python-veteran? En kodningsveteran, der lige er begyndt at lære Python? En nyuddannet fra et bootcamp-program? Vi vil finde et problem, der passer godt til dit erfaringsniveau.

1. Er du bekendt med GitHubs bidragsprocesser?

Bruger du GitHub (eller et lignende websted til deling af kode) til at hoste din egen kode eller 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?

1. 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 fortrolig med, hvordan man bruger GitHub til at oprette en pull request?

1. Har du andre særlige færdigheder, der kan være nyttige?

Er du fortrolig med en GUI API (såsom WinForms, Cocoa eller GTK)? Har du indgående kendskab til et bestemt operativsystems indre funktioner? Er du ekspert i et andet programmeringssprog end Python? Hvis du ikke har nogen særlige færdigheder, er det ikke noget problem – men hvis vi har en Windows-guru i vores midte, vil vi gerne sikre os, at disse færdigheder udnyttes optimalt.

1. Hvorfor er du blevet medlem, og hvad interesserer du dig for?

"Du lød som et venligt projekt" er et helt fint svar. Men hvis der er mere bag, hvorfor du er kommet til os i dag, så lad os det vide. Er du interesseret i mobil- eller desktopudvikling? Pakning? Hjemmesider? Konsolapps? Hvis du ikke har en specifik interesse – hvad synes du så er mest interessant ud fra det, du har set om BeeWare 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 sandsynligvis henvist dig til en del af BeeWare-projektet, hvor du kan bidrage; de har måske endda foreslået et specifikt emne, du kan arbejde med. 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.

Følg disse trin for at filtrere en GitHub-problemoversigt efter mærket "godt første problem":

1. Klik på knappen "Etiketter" over listen over problemer for at aktivere rullemenuen.
2. Skriv ordet "god" i søgefeltet øverst i rullemenuen.
3. Klik på "god første udgave" i den filtrerede liste.

Filtrering af GitHub-problemer efter mærket "godt første problem".

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.

Opsæt et udviklingsmiljø

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:

• Briefcase
• Toga
• Rubicon ObjC

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 korrekturlæser flette PR'en - og så er du færdig! Tillykke - du har bidraget til BeeWare! Hvis dette er dit allerførste bidrag til BeeWare, har du også tjent din BeeWare Challenge Coin - find et medlem af kerneteamet, så vil de 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.

Hvad sker der, hvis jeg ikke fuldfører mit bidrag under sprinten?

Intet problem! Du kan indsende et bidrag når som helst. Et af målene med sprints er at opmuntre og motivere dig til at fortsætte med at bidrage resten af året. Bee Team står til rådighed for at hjælpe dig med alle dele af denne proces.

Hvis du allerede arbejdede på et GitHub-problem eller indsendte en PR, kan du fortsætte med at kommunikere via GitHub. Hvis du har andre spørgsmål eller har brug for hjælp i realtid, er det bedste sted at finde os på BeeWare Discord-serveren. Vi ser frem til at fortsætte samarbejdet med dig!

Forbedring af denne vejledning

Hvis du har forslag til, hvordan vi kan forbedre denne sprintguide, så lad os det vide. Hvad fungerede for dig? Hvad fungerede ikke? Hvad kan vi gøre bedre? Og husk: At løse et problem med denne sprintguide tæller som et bidrag til BeeWare!