Benvenuti agli Sprint di BeeWare!
Benvenuti! Siamo molto contenti che abbiate deciso di unirvi a noi! Se non ti sei ancora presentato a uno dei membri del Bee Team, lo faccia. Una volta una volta fatto, torna qui per iniziare.
Cos'è uno sprint?
Uno sprint è un'opportunità non strutturata per trascorrere alcune ore o giorni di lavoro di lavoro collaborativo su un progetto Open Source. Spesso sono legati a una conferenza; uno sprint dopo una conferenza fornisce un'opportunità per trasformare l'energia, l'entusiasmo e l'interesse che la conferenza ha generato in miglioramenti del software che utilizziamo quotidianamente.
Gli sprint sono anche un'opportunità per introdurre le persone al processo di contribuire al progetto. La nostra speranza è che vi divertiate talmente tanto a che vi divertirete così tanto a contribuire durante lo sprint che tornerete a casa e continuerete a farlo! contribuire!
[Non importa quanta esperienza si abbia (/contributo/prima volta/sindrome dell'imitatore/). Negli sprint passati, abbiamo unito i contributi di persone con qualsiasi livello di esperienza - studenti delle scuole superiori, neolaureati, persone che non si considerano programmatori e sviluppatori esperti. Non importa il vostro livello di esperienza, possiamo trovare un modo per contribuire.
Il codice non è l'unico modo per contribuire. Un progetto come BeeWare è molto di più del solo codice: abbiamo bisogno di persone che scrivano, di persone che scrivano, correggano e traducano la documentazione; abbiamo bisogno di persone che migliorino la delle pagine web; persino il processo di esaminare i bug che sono stati segnalati anni fa e determinare che sono stati risolti lungo il percorso è un contributo prezioso.
Le domande iniziali
Per iniziare, vi faremo alcune domande per valutare i vostri interessi e le vostre esperienze. i vostri interessi e la vostra esperienza. Questo ci aiuterà a trovare il modo migliore per di contribuire. Lavorate sulle domande, prendete appunti, poi trovate un membro del team Bee e condividete le vostre risposte. un membro del Bee Team e condividete le vostre risposte. Se non capite la domanda la domanda posta, non preoccupatevi! Fateci sapere cosa sapete sapere, e lavoreremo insieme per trovare una soluzione.
**Avete già usato BeeWare?
Se non l'avete ancora fatto, iniziate con l'esercitazione [BeeWare Tutorial] (https://docs.beeware.org/en/latest/). Questo manuale vi fornirà un'introduzione introduzione al progetto BeeWare e al modo in cui i pezzi del progetto si del progetto. Se si riscontrano problemi durante l'esercitazione, prendere appunti. tutorial, prendete appunti, perché assicurarsi che nessun altro abbia lo stesso problema problema è un ottimo argomento per un primo contributo!
Dopo aver completato l'esercitazione almeno fino al passo 4, passate alla domanda successiva. alla domanda successiva.
**Quale attrezzatura informatica avete con voi?
L'attrezzatura che avete con voi pone dei limiti pratici a ciò che potete contributo. Per esempio, se avete un computer portatile Windows, non potrete non sarete in grado di lavorare su nulla che abbia a che fare con iOS. Il vostro portatile funziona con Windows, macOS, Linux o qualcos'altro? Il vostro telefono un dispositivo iOS o Android? I vostri dispositivi sono stati forniti dal vostro datore di lavoro o sono dispositivi personali?
**Quanta esperienza avete nello scrivere codice Python?
Siete nuovi alla programmazione? Un veterano di Python? Un veterano del coding che ha appena iniziato a imparare Python? Un neolaureato di un programma di bootcamp? Vogliamo trovare un problema che sia adatto al vostro livello di esperienza. il vostro livello di esperienza.
**Conoscete i processi di contribuzione di Github?
Utilizzate GitHub (o un sito simile di condivisione del codice) per ospitare il vostro proprio codice o per contribuire a progetti di altri? Sapete cos'è la CI (integrazione continua)? Avete contribuito a un progetto che ha dei ganci di pre-commit? Se vi chiedessi di "rifare il vostro PR su main", sapreste cosa fare?
**Hai già contribuito a un progetto Open Source?
Avete partecipato a uno sprint in passato? Avete mai inviato una PR (richiesta di pull) a un progetto Open Source? Avete familiarità con l'uso di utilizzare Github per creare una richiesta di pull?
**Ha altre competenze speciali che potrebbero essere utili?
Avete familiarità con un'API GUI (come Winforms, Cocoa o GTK)? Avete una conoscenza approfondita degli interni di un particolare sistema operativo? sistema operativo? Siete esperti in un linguaggio di programmazione diverso da diverso da Python? Se non avete competenze particolari, non è un problema. ma se abbiamo tra le mani un guru di Windows, vogliamo assicurarci che queste assicurarci che queste competenze vengano utilizzate al meglio.
**Perché si è unito a noi e cosa le interessa?
"Sembrava un progetto amichevole" è una risposta che va benissimo. Tuttavia, se il motivo per cui vi siete uniti a noi oggi è un altro, fatecelo sapere. Siete interessati allo sviluppo mobile o desktop? Packaging? Siti web? Applicazioni per console? Se non hai un interesse specifico, cosa ti sembra più interessante in base a ciò che hai visto su BeeWare? sembra più interessante in base a ciò che avete visto finora su BeeWare? finora?
Ora, trovate un membro del team Bee per condividere le vostre risposte. Potrebbero fare delle domande di approfondimento, ma poi vi indicheranno un'area in cui potrete un'area in cui potreste dare il vostro contributo.
Trova il tuo problema
Se avete parlato con un membro del Bee Team, probabilmente vi ha indicato una parte del progetto BeeWare in cui potete contribuire. probabilmente vi ha indicato una parte del progetto BeeWare a cui potete contribuire; potrebbe anche avervi suggerito un problema specifico su cui potrebbe anche avervi suggerito un problema specifico su cui lavorare. Se non vi hanno specifico, probabilmente vi hanno indicato le "Buone prime questioni" per quel progetto. First Issues" per quel progetto. Che cosa significa?
GitHub fornisce un elenco di problemi che consente a BeeWare (e ad altri progetti) di tenere traccia di tutti i problemi segnalati. progetti) di tenere traccia di tutti i problemi che sono stati segnalati. che includono bug espliciti, comportamenti inaspettati che potrebbero essere un bug, richieste di nuove funzionalità, richieste di maggiore documentazione - tutto ciò che che potrebbe essere un modo per migliorare BeeWare. Quando vengono segnalati nuovi problemi nuovi problemi, il team di Bee li segnalerà come problemi adatti a chi contribuisce per la prima volta. come problemi adatti a chi contribuisce per la prima volta. non richiedono una soluzione immediata, ma sono ben definiti o facili da riprodurre e probabilmente hanno un buon indizio sulla causa sottostante. Questi problemi sono etichettati come "buon primo problema" per renderli più facili da trovare.
Per filtrare un elenco di problemi di GitHub in base all'etichetta "buon primo problema", seguire i questi passaggi:
- Fare clic sul pulsante "Etichette" sopra l'elenco dei problemi per attivare il menu a discesa. il menu a discesa.
- Digitare la parola "buono" nella casella di ricerca in cima al menu a discesa. menu a tendina.
- Cliccate su "buona prima emissione" nell'elenco filtrato.
Una volta trovato un argomento che vi sembra interessante, leggete tutti i commenti sul post e inserire un commento nella discussione dicendo che che si sta esaminando il problema (ad esempio, "Sto esaminando questo problema durante gli sprint di PyCon US 2025"). BeeWare non "assegna" esplicitamente i problemi: accettiamo i contributi di chiunque. contributi da chiunque. Tuttavia, in una situazione di sprint, abbiamo bisogno di assicurarci di non ritrovarci con due persone che lavorano sullo stesso problema. lasciare un commento è un modo leggero per coordinarsi tra collaboratori.
Se non riuscite ancora a trovare qualcosa che vi interessa, cercate un membro del Bee Team che vi aiuterà a individuare un problema specifico. che vi aiuterà a individuare un problema specifico.
Impostare un ambiente di sviluppo
Una volta individuato un problema, è necessario configurare l'ambiente di sviluppo per poter in modo da poter lavorare a una soluzione. Ogni progetto BeeWare ha la sua guida al contributo:
Se il progetto non è presente in questo elenco, controllare il README del progetto per i dettagli su come configurarlo. Se le istruzioni non hanno senso (o se non si riesce a trovarle), è bene cercare un membro del team di Bee non riuscite a trovare le istruzioni), cercate un membro del team Bee, che vi aiuterà a risolvere il problema. vi aiuterà a risolvere il problema. E se pensate di poter migliorare le istruzioni in modo che altre persone non abbiano lo stesso problema, migliorare la guida ai contributi è un contributo prezioso! guida ai contributi è un contributo prezioso!
Ora potete iniziare a lavorare sul vostro problema!
Cosa succede dopo aver inviato la mia PR?
Una volta inviata la richiesta di pull e una volta che la richiesta di pull ha superato tutti i controlli automatici, si è pronti per la revisione. tutti i controlli automatici, si è pronti per una revisione. Comunicare a uno dei membri del team che avete una PR pronta per essere revisionata e loro la esamineranno. occhiata.
Se si tratta della vostra prima PR, è molto probabile che la revisione trovi alcuni problemi. problemi. Potrebbe trattarsi di un caso limite che non avete considerato o di una convenzione di codice che non avete seguito. Non scoraggiatevi! Nessuno, nemmeno nessuno, nemmeno il team centrale, riesce a correggere le PR al 100% al primo tentativo.
Una volta che la PR ha superato la revisione, il vostro revisore unirà la PR e il gioco è fatto. fatto! Congratulazioni - hai contribuito a BeeWare! Se questo è il tuo primo contributo a BeeWare, hai anche guadagnato la tua Moneta Sfida BeeWare](/contributo/challenge-coin). Challenge Coin - trova un membro del e ti darà una moneta!
Aiuto! Sono bloccato!
Se vi bloccate in qualche punto del percorso, cercate un membro del Bee Team. Team. Non abbiate paura di fare qualsiasi domanda. Se siete bloccati, vogliamo disincastrarti. Se siete confusi, è perché l'argomento è complicato e non abbiamo spiegato complicato e non lo abbiamo spiegato abbastanza bene. Siamo desiderosi di di aiutarvi e vogliamo assicurarci che abbiate uno sprint di successo.
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!