Contribuire

Parecchi sono i modi con i quali puoi dare una mano al progetto, a seconda del tempo e delle capacità che vorrai mettere a disposizione.

Segnalazione errori o richieste

Puoi aiutare il lavoro degli sviluppatori notificando errori nelle canzoni o nella resa grafica del documento, facendo richiesta di aggiunte di canzone o, più in generale, offrendo suggerimenti. Per fare questo è sufficiente andare alla pagina di ​apertura di una nuova segnalazione e compilare con cura il modulo.

Sviluppo attivo

Il progetto è agli inizi e più di ogni altra cosa c'è bisogno di persone che aggiungano canzoni alla collezione. Quindi, se hai una vaga dimestichezza con ​LaTeX, o hai voglia di imparare ad usare questo magnifico linguaggio di formattazione e impaginazione, puoi unirti alla squadra di sviluppatori.

Prima però dovrai munirti di alcune conoscenze e di alcuni strumenti descritti di seguito.

Stesura

Per poter scrivere nuovo codice assieme alla squadra di sviluppatori è importante seguire le regole di sviluppo. Si tratta di alcune semplici convenzioni che uniformano quanto prodotto per migliorare la qualità del canzoniere e la leggibilità del codice e che facilitano la collaborazione.

Compilazione

Per compilare il canzoniere è necessario disporre di una distribuzione LaTeX e del pacchetto dello stile ​`songbook` con relative dipendenze.

Controllo di versione

Per agevolare lo sviluppo è disponibile un servizio di controllo di versione con deposito ​Subversion al seguente URL: ​svn://svn.xt3.it/var/svn/osso. Se hai bisogno di altre informazioni fai riferimento alla ​guida italiana al controllo di versione con Subversion.

Gestione del progetto

​Trac è il portale di gestione del progetto, uno strumento molto utile per coordinare le attività dei collaboratori . Offre wiki, segnalazione di errori, interfaccia al sistema di controllo di versione e pianificazione delle attività. Alcune informazioni sono reperibili dalla breve guida inglese all'uso di Trac.