Guida ai contributi¶
Ci sono molti modi per contribuire a BeeWare. Queste guide coprono tutto ciò che devi sapere per fornire il tuo contributo.
Cosa posso fare?¶
Risolvere un problema¶
Il contributo più ovvio che potete dare è scrivere codice per risolvere un problema noto.
Implementare una nuova funzione¶
A {{ nome_formale }} manca una funzione che vorresti vedere? È possibile implementare una nuova funzionalità.
Scrivere la documentazione¶
Nessuna funzione è completa finché non è ben documentata. Scrivere documentazione è un modo per contribuire che non comporta la scrittura di codice.
Triage di un problema¶
Ogni volta che qualcuno segnala un nuovo problema, questo deve essere analizzato. La gestione di un problema consiste nel prendere le informazioni fornite dal segnalatore e cercare di riprodurre il problema descritto.
Rivedere una richiesta di pull¶
Una volta che una richiesta di pull è stata inviata, deve essere rivista prima di poter essere unita. Indipendentemente dal fatto che si abbia una profonda familiarità con il contenuto, è probabile che si possa contribuire alla revisione di una richiesta di pull.
Suggerisci una nuova funzione¶
Avete un suggerimento o un'idea per una nuova aggiunta a uno degli strumenti di BeeWare? Potete proporre una nuova funzionalità per essere presi in considerazione.
Traduci contenuto¶
BeeWare mantiene una documentazione in diverse lingue. Se conoscete una lingua diversa dall'inglese, potete aiutarci a tradurre il contenuto.
Usa gli strumenti¶
Avete un'idea per un'applicazione realizzata con Toga? Avete un'applicazione esistente che potrebbe essere confezionata con Briefcase? Potete utilizzare gli strumenti e fornire un feedback sulla vostra esperienza.
Come posso contribuire?¶
Impostare un ambiente di sviluppo¶
Prima di iniziare a contribuire a BeeWare, è necessario configurare l'ambiente di sviluppo.
Riprodurre un problema¶
Prima di risolvere un problema, è necessario verificarne l'esistenza. Anche la riproduzione di un problema è una parte importante del triage.
Lavoro da un ramo¶
Quando ci si prepara a presentare un contributo, bisogna sempre lavorare da un ramo.
Evitare la dispersione del campo di applicazione¶
È importante mantenere la concentrazione ed evitare lo scope creep con il vostro contributo.
Proporre una nuova funzione¶
Per proporre una nuova funzione seguite questi passaggi.
Scrivere, eseguire e testare il codice¶
Per aggiornare o contribuire al codice, è necessario scrivere, eseguire e testare il codice.
Documentazione di costruzione¶
Per aggiornare o contribuire alla documentazione, è necessario essere in grado di costruire i documenti.
Scrivere la documentazione¶
Per contribuire alla documentazione, dovrete scrivere nuovi contenuti o aggiornare quelli esistenti.
Aggiungere una nota di modifica¶
Ogni richiesta di pull dovrebbe essere accompagnata da una nota di modifica.
Invia una richiesta di pull¶
Quando le modifiche sono pronte, si invia una richiesta di pull per la revisione.
Fornisci una recensione¶
Se ti senti a tuo agio, puoi fornire una recensione del contributo di qualcun altro.
Traduci contenuto¶
BeeWare utilizza Weblate per le traduzioni, che richiede alcuni passaggi per iniziare.
Invia un nuovo numero¶
Se ci si imbatte in un nuovo problema o bug, è utile inviare un problema.
Cosa succede dopo?¶
revisione della richiesta di pull¶
Quando viene inviata una richiesta di pull, il passo successivo è la revisione delle PR.
Il processo di rilascio¶
I contributi uniti passeranno attraverso il processo di rilascio.
Guide di stile¶
Codice stile guida¶
Queste sono le linee guida per contribuire al codice dei progetti BeeWare.
Guida allo stile della documentazione¶
Queste sono le linee guida per contribuire alla documentazione dei progetti BeeWare.