Il punto di partenza migliore per qualsiasi contributo open source è qualcosa che si adatta alle vostre conoscenze, esperienze e aree di interesse.

Prima di iniziare

Prima di iniziare a contribuire, può essere utile farsi un'idea del progetto nel suo complesso. Se non si è già fatto il [Tutorial di BeeWare Tutorial] (https://docs.beeware.org), iniziate da lì. Questo vi darà strumenti più importanti di BeeWare, in modo da capire come si integrano tra loro. come si integrano tra loro.

Una volta completata l'esercitazione, sarete pronti a scegliere qualcosa su cui su cui lavorare. Se avete avuto problemi a fare l'esercitazione, se avete riscontrato un bug o se il linguaggio usato per descrivere un passo non era chiaro, questo è un problema. bug, o se il linguaggio usato per descrivere un passo non era chiaro, questo è un ottimo punto di partenza! ottimo punto di partenza! Se riuscite a trasformare la vostra esperienza in un miglioramento del tutorial, la prossima persona che lo farà non incontrerà lo stesso problema. lo stesso problema.

Tuttavia, se la vostra esperienza di tutorial è stata del tutto regolare (e ci auguriamo che lo sia stata!), ecco alcune idee su dove intervenire, a seconda del tipo di intervento. e ci auguriamo che lo sia stata!), ecco alcune idee per il coinvolgimento, a seconda delle vostre capacità e dei vostri interessi. delle vostre capacità e dei vostri interessi.

Programmazione Python

Cartella

Se desiderate contribuire a uno strumento che ha un problema chiaramente definito, ma che ha bisogno di ma che ha bisogno di eliminare i bug e aggiungere funzionalità, Briefcase potrebbe essere il progetto che fa per voi. per voi. Briefcase è uno strumento che permette di impacchettare un progetto Python come applicazione applicazione GUI indipendente. Prende un file di configurazione `pyproject.toml' e e utilizza i dati di configurazione per generare installatori o pacchetti di applicazioni bundle di applicazioni distribuibili.

La Valigetta issue tracker ha una collezione di suggerimenti di funzionalità (e un numero minore di bug). Se è la prima volta che prima volta che contribuite, cercate uno dei ticket con la dicitura good primo issue - Si tratta di problemi che sono stati scelti specificamente per i primi per la prima volta, perché dovrebbero essere relativamente semplici da implementare. Può essere utile filtrare i ticket per la piattaforma che si usa effettivamente per lo sviluppo. piattaforma che si usa effettivamente per lo sviluppo: sarà difficile risolvere un bug di un bug di Linux se non si ha una macchina Linux da usare per i test!

Se volete contribuire a un progetto specifico, potete anche filtrare i primi problemi per progetti specifici utilizzando questi link:

Scegliete un ticket, lasciate un commento sul fatto che state esaminando il problema, e provare a sviluppare una richiesta di pull per implementare una correzione!

GUI programming

Se avete esperienza con una libreria di widget nativa - Cocoa su macOS, GTK+ su Linux, Windows Forms o le librerie native di iOS o Android, potreste essere in grado di aiutare con Toga. Toga è un kit di strumenti per widget multipiattaforma che fornisce un'interfaccia comune per elementi dell'interfaccia utente come pulsanti e alberi.

Toga ha una serie di interfacce già definite; tuttavia, l'implementazione di tali interfacce non è completa su tutte le piattaforme. di queste interfacce non è completa per tutte le piattaforme. Scegliete un widget e implementatelo per la piattaforma che preferite!

Anche se non conoscete una libreria di widget nativa, potreste essere in grado di aiutarci con Toga. aiutare con Toga. Scrivere nuovi widget è molto meno complicato di quanto può sembrare. Ogni piattaforma ha una documentazione che spiega come usare le sue API native e il processo di traduzione della documentazione di tale piattaforma da una lingua un altro linguaggio (ad esempio, Objective C o C#) è un processo relativamente semplice. Il codice esistente dovrebbe fornire alcune indicazioni su come di come si può fare, e il team di BeeWare è felice di aiutarvi se ne avete bisogno. bisogno. Collegatevi a [BeeWare Discord] (/bee/chat/) e faremo tutto il possibile per aiutarvi! possibile per aiutarvi!

Se non siete disposti a trasformare il codice da un linguaggio a un altro - c'è sempre la suite di test. Anche la libreria di base di Toga ha una suite di test ma la copertura della suite di test non è molto buona. Scegliete un e vedere se si riesce a scrivere un test per esso!

Documentazione

Una buona documentazione è essenziale per il successo di qualsiasi progetto. Sappiamo che Toga e Briefcase hanno entrambi bisogno di significativi miglioramenti alla loro documentazione. Avete fatto il tutorial; ora date un'occhiata alla documentazione di Toga. ora date un'occhiata alla documentazione di Toga e di Briefcase e vedete se vi sembra di poter migliorare la documentazione. Briefcase e vedete se riuscite a trovare un modo per migliorare modo di migliorare i tutorial, i riferimenti e le guide agli argomenti che vi sono che ci sono.

Tutorial

Uno dei modi migliori per contribuire è quello di assicurarsi che la nostra documentazione introduttiva e documentazione introduttiva e di esercitazione sia solida come una roccia. Scegliete un progetto di interesse dalla della suite BeeWare e cercare di seguire la guida introduttiva e il tutorial. tutorial. Se non riuscite a trovare la guida introduttiva, questa è la prima cosa da segnalare! la prima cosa da segnalare!

Durante la lettura del tutorial, prendete nota di tutto ciò che non ha senso o non funziona. senso o che non funziona. Aprite quindi una segnalazione di bug per questi problemi.

Windows

Se siete utenti di Windows, BeeWare può definitivamente utilizzare il vostro aiuto. Il team utilizzano tutti Linux e macOS nello sviluppo quotidiano e, di conseguenza, è davvero facile che di conseguenza, è molto facile che si verifichino incompatibilità con Windows. Questo è quasi sempre dovuto a una svista. Identificare, e forse anche risolvere i problemi legati all'esecuzione degli strumenti BeeWare su Windows è di immenso aiuto.

Lingue

Parli una lingua diversa dall'inglese? Al momento, il team principale sono tutti di madrelingua inglese. Fornire traduzioni di documentazione, o tutorial o guide completamente nuove nella vostra lingua madre lingua è un ottimo modo per contribuire. Scegliete un progetto che abbia già documentazione e tradurre quel testo. In alternativa, partite da zero e scrivere un tutorial completamente nuovo.

Se si parla una lingua con un set di caratteri non latini (ad esempio, russo o cinese), o una lingua con una scrittura da destra a sinistra (ad esempio, ebraico o cinese). cinese), o una lingua con una scrittura da destra a sinistra (ad esempio, l'ebraico o l'arabo), sarete in grado di indicare tutti i punti in cui abbiamo ipotizzato di utilizzare la scrittura a sinistra. arabo) potrete indicarci tutti i punti in cui abbiamo assunto la semplice codifica semplice codifica ASCII o convenzioni da sinistra a destra. Scegliete uno qualsiasi dei progetti BeeWare attivi e provate a usarlo con la vostra lingua madre. lingua. Se ci sono problemi, segnalateli come bug; se vi sentite particolarmente avventurosi, vedete di se vi sentite particolarmente avventurosi, vedete se riuscite a capire come correggere il bug.

Uso pratico

Uno dei modi migliori per determinare dove sono le nostre lacune, sia nella documentazione che nelle sia nella documentazione che nelle API, è che le persone usino effettivamente BeeWare per costruire qualcosa. Quindi, se nessuna delle idee proposte finora vi sembra interessante, perché non provate a fare qualcosa di vostro? provare a fare qualcosa di proprio? Utilizzate la suite BeeWare per creare l'applicazione che avete sempre desiderato. un'applicazione che avete sempre desiderato: una visualizzazione desktop di una fonte di dati o un'applicazione mobile per monitorare le vostre attività. un'applicazione mobile per monitorare le vostre attività: qualunque cosa sia, provate a costruirla. costruirla.

Possiamo quasi garantire che incontrerete dei problemi. BeeWare è un progetto ancora progetto molto giovane. Ma i problemi che incontrerete ci daranno un'ottima indicazione di ciò che deve essere affrontato. Ci indicherà di quali widget abbiamo di cui abbiamo bisogno e quale documentazione deve essere migliorata. Quindi, quando incontrate problemi nella costruzione della vostra applicazione, registrate i problemi con i progetti BeeWare che hanno causato i problemi. che hanno causato problemi. Questo ci consentirà di identificare gli aspetti da migliorare. migliorare - e potrebbe anche essere una fonte di ispirazione per voi per contribuire!