Guida allo sprint¶
Benvenuti agli Sprint 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.
Che 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 hai. Negli sprint precedenti abbiamo unito i contributi di persone con diversi livelli di esperienza: studenti delle scuole superiori, neolaureati, persone che non si considerano programmatori e sviluppatori esperti. Indipendentemente dal tuo livello di esperienza, troveremo un modo per farti 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.
- Hai mai usato BeeWare prima d'ora?
Se non l'hai ancora fatto, inizia seguendo il Tutorial BeeWare. Ti fornirà un'introduzione al progetto BeeWare e ti spiegherà come i vari elementi del progetto si integrano tra loro. Se incontri qualche problema durante il tutorial, prendi appunti: assicurarti che nessun altro abbia lo stesso problema è un ottimo argomento per un primo contributo!
Una volta completato il tutorial almeno fino al punto 4, passa alla domanda successiva.
- Che tipo di attrezzatura informatica hai con te?
Le attrezzature che hai a disposizione limitano concretamente il tuo contributo. Ad esempio, se hai un laptop Windows, non potrai lavorare su nulla che abbia a che fare con iOS. Il tuo laptop funziona con Windows, macOS, Linux o altro? Il tuo telefono è un dispositivo iOS o Android? I tuoi dispositivi sono stati forniti dal tuo datore di lavoro o sono tuoi dispositivi personali?
- Quanta esperienza hai nella scrittura di codice Python?
Sei alle prime armi con la programmazione? Sei un esperto di Python? Sei un esperto di programmazione che ha appena iniziato a imparare Python? Hai appena completato un programma di formazione intensivo? Vogliamo trovare un problema che sia adatto al tuo livello di esperienza.
- Conosci i processi di contribuzione di GitHub?
Usi GitHub (o un sito simile per la condivisione di codice) per ospitare il
tuo codice o contribuire ai progetti di altri? Sai cos'è la CI (integrazione
continua)? Hai mai contribuito a un progetto che ha hook pre-commit? Se ti
chiedessi di "rebase il tuo PR rispetto al main", sapresti cosa fare?
- Hai mai contribuito a un progetto Open Source?
Hai mai partecipato a uno sprint in passato? Hai mai inviato una PR (pull request) a un progetto Open Source? Sai come usare GitHub per creare una pull request?
- Hai altre competenze particolari che potrebbero essere utili?
Hai familiarità con un'API GUI (come WinForms, Cocoa o GTK)? Hai una conoscenza approfondita dei meccanismi interni di un particolare sistema operativo? Sei un esperto in un linguaggio di programmazione diverso da Python? Se non hai competenze particolari, non è un problema, ma se abbiamo tra noi un guru di Windows, vogliamo essere sicuri che le sue competenze vengano messe a frutto.
- Perché ti sei unito a noi e cosa ti interessa?
"Mi sembrava un progetto interessante" è una risposta perfettamente valida. Tuttavia, se ci sono altri motivi per cui ti sei unito a noi oggi, faccelo sapere. Ti interessa lo sviluppo mobile o desktop? Il packaging? I siti web? Le applicazioni console? Se non hai un interesse specifico, cosa ti sembra più interessante di BeeWare in base a ciò che hai visto 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 hai parlato con un membro del Bee Team, probabilmente ti avrà indicato una parte del progetto BeeWare a cui puoi contribuire; potrebbe anche averti suggerito una questione specifica su cui lavorare. Se non ti ha indicato una questione specifica, probabilmente ti avrà indicato le "Good First Issues" (buone questioni iniziali) per quel progetto. 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 GitHub in base all'etichetta "good first issue", procedi come segue:
- Clicca sul pulsante "Etichette" sopra l'elenco dei problemi per attivare il menu a tendina.
- Digita la parola "buono" nella casella di ricerca nella parte superiore del menu a tendina.
- Clicca su "buon primo numero" nell'elenco filtrato.
Filtraggio delle segnalazioni GitHub in base all'etichetta "good first issue" (buona prima segnalazione).
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.
Configurare 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 richiesta di residenza permanente?¶
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 avrà superato la revisione, il revisore unirà la PR e il gioco è fatto! Congratulazioni, hai contribuito a BeeWare! Se questo è il tuo primo contributo a BeeWare, hai anche guadagnato la tua BeeWare Challenge Coin: trova un membro del team principale 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.
Cosa succede se non completo il mio contributo durante lo sprint?¶
Nessun problema! Puoi inviare un contributo in qualsiasi momento. Uno degli obiettivi degli sprint è quello di incoraggiarti e motivarti a continuare a contribuire per tutto il resto dell'anno. Il Bee Team è a tua disposizione per aiutarti in qualsiasi fase di questo processo.
Se stavi già lavorando su un problema GitHub o hai inviato una PR, puoi continuare a comunicare tramite GitHub. Se hai altre domande o hai bisogno di assistenza in tempo reale, il posto migliore per trovarci è il server Discord di BeeWare. Non vediamo l'ora di continuare a lavorare con te!
Migliorare questa guida¶
Se avete suggerimenti su come migliorare questa guida agli sprint, fatecelo sapere. Cosa ha funzionato per voi? Cosa non ha funzionato? Cosa possiamo migliorare? E ricordate: risolvere un problema problema con questa Guida agli Sprint vale come contributo a BeeWare!