Contribuire al progetto MariaDB
Contents
Perché contribuire?
Il successo di MariaDB dipende dalla partecipaziona della comunità. MariaDB non avrebbe la qualità che ha raggiunto oggi, senza la partecipazione della comunità.
Primi passi
Ecco diversi modi per contribuire, e non tutti richiedono una grande conoscenza di C/C++. Tra le aree per i non-sviluppatori ci sono:
- Segnalare i bug
- Per segnalare un bug occorre creare un account cliccando sul link Sign Up sotto ai campi del login
- Suggerire funzionalità
- Rispondere alle domande nella Knowledgebase.
- Effettuare test e benchmark
- I test dei bug possono essere caricati nella directory 'private' del server FTP di AskMonty.
- Creare documentazione e articoli della KB su MariaDB, o tradurre la documentazione esistente.
- Diffondere MariaDB nella propria regione
- Partecipare agli eventi aull'open source e parlare di MariaDB.
- Far girare un BuildBot su una piattagorma che non è attualmente rappresentata.
- Donare tempo o denaro al progetto MariaDB.
Contribuire alla Knowledgebase è un ottimo modo per aiutare a migliorare MariaDB.
Mailing list di MariaDB
Un ottimo modo per avvicinarsi a MariaDB è partecipare alle discussioni via email o via Launchpad (nelle liste che maggiormente vi interessano):
Si possono trovare ulteriori indirizzi email, archivi e altri modi per connettersi al popolo di MariaDB qui.
Tutti coloro che contribuiscono a MariaDB devono rispettare il Codice di condotta di Ubuntu.
Primi passi per gli sviluppatori
Ci sono diversi motivi per cui contribuire con il codice è uno dei modi più semplici e più gratificanti per contribuire a MariaDB:
- Il codice proposto viene revisionato velocemente. Appena è pronto, viene effettuato il merge in un ramo esistente di MariaDB e viene reso disponibile per chiunque, non solo per alcuni clienti selezionati.
- Le revisioni del codice vengono effettuate dal team degli sviluppatori principali di MariaDB. La qualità, il livello di dettaglio e la tempistica delle revisioni sono migliori di quelle che si possono trovare altrove.
- Con MariaDB tutti hanno accesso al codice più recente.
- Se una patch è molto sicura e/o molto utile, eseguiamo il push nel codice stabile (purché non possa rompere la compatibilità con applicazioni esistenti). Lo facciamo per assicurare la libertà di aggiungere fix piccoli e necessari ad una release stabile, così che gli utenti non debbano aspettare un anno per poter usare una funzionalità critica per i loro bisogni.
- Coloro che collaborano attivamente possono divenire membri di maria-captains, anche se non lavorano per Monty Program Ab. Tutti i captain hanno gli stessi identici diritti di accettare o rifiutare le patch. Lo sviluppo segue un modello molto aperto.
La pagina Aiutare con il codice spiega nel dettaglio le procedure necessarie per poter lavorare al codice sorgente di MariaDB. E' importante utilizzare gli stessi tool e proporre patch nello stesso modo degli altri sviluppatori per far sì che lo sviluppo proceda fluidamente.
Cosa ci si aspetta dagli sviluppatori
Ogni bit di codice può essere accettato in MariaDB; ma, in generale, ci si aspetta che il codice proposto:
- sia bello, modulare, performante, facile da leggere e presumibilmente privo di bug
- sia stato revisionato appropriatamente da almeno un maria-captain
- segua gli standard del codice di MariaDB
- non contenga codice duplicato / funzionalità già presenti
- fornisca un'aggiunta apprezzabile a MariaDB ci cui un gran numero di utenti possano beneficiare
- non comprometta niente per i vecchi utenti di MySQL / MariaDB
- non blocchi nessuno che deve sviluppare un'altra funzionalità importante
Sul piano personale, ci si aspetta che lo sviluppatore:
- segua il Codice di Condotte di Ubuntu
- partecipi alle discussioni via email sulle liste Launchpad (qualunque sia la lista più appropriata:
- Si registri come sviluppatore di Maria su Launchpad
- mantenga un atteggiamento positivo, produttivo e a cuor leggero. La comunità capisce sempre gli sviluppatori che si allontanano temporaneamente ed educatamente per assicurare una vera produttività. L'enfasi è su "educatamente"
- lavori con i maria-captains per far approvare il proprio codice
- proponga il codice approvato al captain che ha lavorato alla revisione o alla mailing list perché venga incluso in MariaDB
- prenda possesso del codice che propone e interagisca come coesivo insieme agli altri sviluppatori che possiedono del codice. Questo significa:
- correggere i bug nel proprio codice
- revisionare, approvare o riproporre una propria versione del codice proposto da altri, se va a toccare il proprio codice
- essere disponibili per le persone che desiderano discutere su quel codice
- aiutare ad aggiornare il codice da una versione di MariaDB alla successiva
Se non si può o non si vuole rispondere alle aspettative qui esposte, i maria-captain, oppure Monty Program Ab, troveranno qualcun altro che si prenda carico del codice dello sviluppatore.
Licenze
Similarmente ad altri progetti open source, Monty Program Ab ha bisogno di avere una proprietà condivisa sul codice che viene incluso nella distribuzione di MariaDB. Per ottenere questo, si può inviare il codice con licenza BSD-new. Le uniche eccezioni attualmente note a questa regola sono gli Storage Engine e il codice caricabile attraverso un plugin. In questi casi, è sufficiente che il codice sia GPL.
Se si vuole proporre il codice sotto una licenza che non sia BSD-new, bisogna firmare e spedire sia mail il Monty Program Contributor Agreement.
Dove sono gli altri sviluppatori?
- La maggior parte degli altri sviluppatori principali utilizzano il canale IRC #maria su freenode.
- Si può inviare (e discutere) codice, proposte e feature request alla lista maria-developers.
