Il codice sorgente dei moduli di localizzazione italiana si trova su Launchpad. Il controllo di versione è gestito tramite il protocollo di Bazaar.
Il branch principale è italian-addons, contente i moduli di localizzazione. Per poter scrivere su questo branch, è necessario essere membri del team openobject-italia-core-devs. Ogni qualche giorno, i moduli presenti su questo branch vengono prelevati automaticamente e pubblicati su Apps. Chiunque può registrare un nuovo branch.
Le discussioni relative allo sviluppo dei moduli di localizzazione avvengono nella mailing list associata al gruppo su launchpad. Un archivio ricercabile dei messaggi si trova qui
Per poter scrivere codice su Launchpad, è necessario configurare le proprie chiavi SSH
Per aggiungere nuove funzionalità, quindi nuovi moduli, al repository principale, la procedura da seguire prevede i passi branch, sviluppo, merge. Questi passi sono descritti anche nel manuale community, infatti valgono in generale per ogni nuovo modulo di OpenERP (per modificare moduli esistenti, il processo è lo stesso).
Nel nostro caso:
bzr branch lp:openobject-italia lp:~ID_LAUNCHPAD/openobject-italia/add_NUOVO_MODULO
sostituendo ID_LAUNCHPAD con il proprio ID oppure con openobject-italia-core-devs e NUOVO_MODULO con ad esempio il nome del modulo che si sta aggiungendo.
bzr co lp:~ID_LAUNCHPAD/openobject-italia/ADD_NUOVO_MODULO
bzr ci
Tutti i processi di analisi dei requisiti e specifiche funzionali sono gestiti e seguiti tramite i blueprint di launchpad. Quando si inserisce un nuovo blueprint, è bene inserire il team Openobject Italia core devs nel campo Approver. I blueprint possono puntare a pagine di specifiche più dettagliate contenute in questo wiki.
Per maggiori informazioni sui blueprint vedere la guida di launchpad
I bachi legati ai moduli di localizzazione italiana vengono tracciati sul bug tracker di Launchpad.
Chiunque può segnalare un baco. Per chi è meno pratico di sviluppo software, si consiglia di seguire alcune linee guida relative all'apertura di un nuovo baco, come ad esempio Come segnalare bug efficaciemente
Per la documentazione dei moduli di localizzazione si fa riferimento alle pagine di questo wiki.
Il lavoro di traduzione del manuale utente di OpenERP è svolto sempre su Launchpad ed i vari capitoli si trovano al seguente indirizzo: http://bazaar.launchpad.net/~openerp-community/openobject-doc/doc/files/head:/i18n/it/source/book/.
Per partecipare alla traduzione del manuale è necessario ottenere il branch openobject-doc (circa 1 GB ) tramite il comando
bzr branch lp:openobject-doc
I file della traduzione italiana si trovano appunto nelle dir dentro i18n/it/source/book. Per ogni file la struttura del template è piuttosto semplice. Ogni sezione è preceduta dal contesto originale. Di seguito un esempio:
.. i18n: %%%%%%%%%%%%%%%%%%%%%%%%% .. i18n: Open Object Documentation .. i18n: %%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%% Open Object Documentation %%%%%%%%%%%%%%%%%%%%%%%%%
Il contesto è una sezione commentata che inizia con .. i18n. Aiuta a capire il contesto della sezione ed il suo testo originale. Ecco una sezione tradotta:
.. i18n: %%%%%%%%%%%%%%%%%%%%%%%%% .. i18n: Open Object Documentation .. i18n: %%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%% Documentazione di Open Object %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Una volta effettuate le modifiche se ne può fare il commit tramite
bzr commit
e caricarle su Launchpad tramite
bzr push lp:openobject-doc
Per poter fare il push è necessario essere membri del team openerp-community