Partecipare attivamente

Vuoi dare una mano? Bene! Non c'è bisogno di essere esperti di C++, e neanche di perdere troppo tempo. Una grossa fetta dell'aiuto di cui abbiamo bisogno è rappresentata dal feedback degli utenti, ovvero dalle loro risposte, e dalle segnalazioni dei bug. Se i concetti in questa pagina ti sembrano troppo tecnici, non preoccuparti: c'è un'altra pagina in cui parliamo dei modi in cui chiunque può essere coinvolto.

Puoi cominciare anche subito, testando le release ufficiali. Scaricane una e creati un account su Bugzilla: ne avrai bisogno per segnalare i bug (prima di farlo, ti consigliamo di leggere le linee guida alla segnalazione). Se hai in mente di scrivere del codice, leggi i documenti sull'hacking.

Quando cominci a lavorare su qualcosa che richieda più di un giorno di lavoro, ti consigliamo vivamente di farlo sapere a qualcuno: parla del tuo progetto su di un gruppo di discussione adatto (vedi la lista dei titolari per maggiori dettagli). Se stai lavorando alla correzione di un bug, lasciane nota nella relativa pagina presente su Bugzilla, in modo da tener traccia dei tuoi progressi e da ottenere l'attenzione delle altre persone interessate. Se il bug che pensi di aver notato non esiste ancora su Bugzilla, hai l'opportunità di segnalarlo e di assegnarlo a te stesso. Se aggiungi una nuova caratteristica, analogamente, puoi segnalare una richiesta di miglioramento (enhancement request) in Bugzilla e assegnarlo a te stesso: un miglioramento viene considerato a tutti gli effetti come un bug, la cui classificazione è appunto “enhancement”. Continua a leggere questa pagina se vuoi avere maggiori dettagli sul processo di segnalazione e risoluzione dei bug.

Rendere pubblici i tuoi sforzi permette agli altri di sapere su che cosa stai lavorando, così che possano coordinare la loro opera con la tua, offrirti il loro aiuto ed evitare di fare del lavoro duplicato e quindi inutile. Apre la tua opera ad un confronto “fra pari”, e contribuisce all'allestimento di un archivio allo scopo di evitare, nel tempo, il riproporsi degli stessi problemi e soluzioni. Inoltre, se qualcun'altro sta lavorando sulla stessa cosa, può fartelo sapere, e farti risparmiare un mucchio di tempo!

Di cosa c'è bisogno?

Scrivere documentazione

Abbiamo bisogno di documentazione per utenti, sviluppatori Web e programmatori che lavorano a Mozilla. Se scrivi del codice, documentalo. Molto del codice esistente non è molto ben documentato. Se ti viene in mente qualcosa che può essere interessante per la comunità, prova e documenta le tue scoperte. Se hai intenzione di contribuire, faccelo sapere mandando un messaggio sul gruppo di discussione netscape.public.mozilla.documentation e un'e-mail a [email protected]. Oppure contatta il gruppo di traduzione italiana del progetto Mozilla.

Segnalazione di bug

Comincia con lo scaricare una release. Usala quotidianamente e segnalaci i bug quando li trovi. Prima di inviare una segnalazione, fai una ricerca su Bugzilla per assicurarti che il tuo bug non sia già stato segnalato. Se è così, sentiti comunque libero di aggiungere al report qualsiasi dettaglio reputi importante. Prima di segnalare un nuovo bug, leggi le linee guida alla segnalazione. Le segnalazioni dovrebbero essere compilate con cura, in maniera tale che gli sviluppatori possano riprodurre facilmente il problema. Se non ci riescono, sarà difficile - o impossibile - che riescano a correggere il bug.

Collaborazione con i programmatori

Il team di Quality Assurance di Mozilla dedica una pagina ai molti modi di fornire aiuto e supporto ai programmatori. Il lavoro di QA non comporta particolari conoscenze tecniche o di programmazione (sebbene una minima conoscenza di HTML possa essere utile) ed è un buon modo per acquisire familiarità con Mozilla. Alcuni dei campi in cui è possibile fornire supporto sono:

Pre-analisi dei bug Browser-General

Bugzilla riceve mensilmente centinaia di bug relativi al componente Browser-General, perché molti segnalatori non sanno bene a quale componente appartengono in realtà. Questi bug devono essere analizzati per determinare quanto siano validi, e a quale componente del browser appartengano precisamente.

Conferma dei nuovi bug

I bug, appena inviati da chi li segnala, iniziano il loro ciclo di vita nello stato UNCONFIRMED, il che significa che qualcuno deve verificare se il problema esista davvero e se sia davvero un bug. Questo potresti essere tu. Apri questa pagina per ulteriori dettagli.

Partecipa alla BugAThon (la maratona dei bug)

Bugzilla riceve molti bug che gli sviluppatori risolverebbero molto più velocemente se avessero dei testcase più semplici da analizzare. Molti di coloro che segnalano bug si limitano a fornire un URL, senza preoccuparsi di isolare la vera causa del problema. Di conseguenza, gli sviluppatori devono perdere il loro tempo ad isolare i bug piuttosto che a risolverli. Se vuoi aiutarli a sistemare i problemi di DOM e di layout invece di stare a guardare mentre dissezionano segnalazioni, partecipa alla BugAThon e dai il tuo contributo!

Correggi i bug

C'è qualche bug che reputi davvero fastidioso? Invece di limitarti a segnalarlo, se ne sei capace sentiti pure libero di correggerlo! Scrivi una patch e inviala come attachment presso la pagina del bug che ti interessa su Bugzilla. Una volta fatto questo, contatta il titolare del modulo e chiedigli una convalida (review) della patch. In molti casi, sarà necessaria una super-review; dopodiché la tua patch verrà caricata sul repository e Mozilla sarà diventato un prodotto migliore. Tutto questo potrà sembrare complesso, ma noi siamo molto scrupolosi sulla qualità del codice :-).

Quando cominci a lavorare su un bug, assicurati di scrivere una nota nel box dei commenti (Additional comments) della relativa pagina su Bugzilla. Questo permette agli altri di sapere che qualcuno ci sta già lavorando ed aiuta a ridurre la duplicazione degli sforzi. Quando hai finito, crea una patch con “cvs diff -u” e invia la patch su Bugzilla (vedi codice sorgente via CVS e Mozilla hacking). Gli altri potranno così testare la tua patch. Se funziona come previsto e vengono effettuate le necessarie convalide, il responsabile del bug applicherà la patch e chiuderà il bug. Se invece stai aggiungendo una caratteristica, crea una richiesta di miglioramento (enhancement request) ed assegnala a te: vai su Bugzilla e crea un nuovo bug, imposta come severità ‘enhancement’ e come responsabile (‘owner’) te stesso.

Miglioramenti delle prestazioni

Uno dei nostri obiettivi è che Mozilla diventi sempre più veloce ed efficiente. Prova a farlo girare all'interno di un profiler o esegui analisi dell'utilizzo della memoria con un tool come Purify. Anche se non apporti direttamente miglioramenti al codice, i dati raccolti da questi strumenti possono essere di grande aiuto. Consulta il gruppo di discussione netscape.public.mozilla.performance per ulteriori informazioni. Dai un'occhiata ai log di Purify pubblicati dal gruppo di sviluppo del componente Mail/News. Cerca bug relativi ai memory leak in Bugzilla.

Scrivi codice

Sei libero di partecipare a ciascuno dei nostri progetti o di proporne uno nuovo. Probabilmente hai già un'idea di ciò che ti piacerebbe fare, ma se invece non ce l'hai e vuoi trovare il modo di dare una mano, ecco alcuni suggerimenti.

Errori di compilazione

Correggi gli errori e i warnings in fase di compilazione (bug 187528). Consulta la Tinderbox e clicca sulla "L" in una delle caselle verdi. In questo modo potrai prendere visione dei più recenti log di compilazione. Dopo aver corretto l'errore, crea una patch e invia una segnalazione su Bugzilla con la patch inclusa come attachment. Quindi invia una nota sul mozilla.builds forum per annunciare la tua correzione con il relativo numero identificativo del bug.

Richieste di miglioramento

Sfoglia le richieste di miglioramento su Bugzilla e vedi se trovi qualcosa che ti piacerebbe implementare. Qui c'è una (lunga) lista di tutte le enhancement request. Se decidi di lavorare ad una di esse, assegna il bug a te stesso e aggiungi un commento che lo indichi. Invia un messaggio al newsgroup che ti sembra più appropriato, spiegando quali sono le tue intenzioni.

Quando hai del codice funzionante, invia una patch tramite attachment nella pagina del bug, annuncialo nel newsgroup specificando il numero identificativo del bug e lascia che gli altri testino la tua patch. Fallo per ogni nuova versione della patch. Se chi la prova pensa che sia valida, potrà entrare a far parte del codice.

Contatta i siti web che hanno problemi

I tuoi siti web preferiti funzionano bene con Mozilla e con i browser basati su di esso? Se questo non accade, puoi contribuire al successo e alla diffusione di Mozilla cercando di convincere i responsabili dei siti e gli sviluppatori web a sviluppare contenuti basandosi sugli standard web internazionali, rendendo così il sito consultabile con ogni browser, incluso Mozilla.

Puoi dare un aiuto al progetto Mozilla Technology Evangelism inviando bug di Tech Evangelism riguardanti siti che non funzionano con Mozilla, aiutando a catalogare questi bug in base alla gravità e lamentandoti con i siti che non supportano il tuo browser preferito!

Se proprio non trovi nulla che faccia al caso tuo, prova a dare uno sguardo alle pagine dei gruppi di discussione, degli aggiornamenti sullo stato e dei progetti, e fai attenzione se c'è qualcuno che chiede aiuto. Se ti accorgi che qualche bug o miglioramento viene rimandato di troppo (ad esempio se viene spostato di qualche milestone più avanti), puoi provare a chiedere al responsabile se puoi fare qualcosa per aiutare. Se un bug viene impostato per essere risolto molte release più avanti, probabilmente il responsabile di quel bug ha bisogno di gente che ci lavori. Prova a fare una ricerca su Bugzilla dei bug impostati per essere risolti una milestone o due più avanti rispetto all'attuale.