Formato sorgenti
E' una discussione praticamente ancora aperta. Le soluzioni proposte girano attorno a tre validi strumenti:
- Latex: e' uno dei sistemi per la preparazione dei testi piu' usato in ambito accademico e semi-professionale. Ha dalla sua la facilita' di utilizzo (non banale se qualcuno non lo conosce), un buon outputting in PDF, che e' anche la principale caratteristica per la quale si preferisce Latex ad altri strumenti di desktop publishing. Per quanto riguarda il formato HTML (o XHTML), ci sono parecchi problemi. Esistono molti strumenti per la conversione da sorgente latex a HTML, ma questi producono del codice che dovremmo poi ritoccare per farlo aderire agli standard (cosa a cui puntiamo) e per renderlo presentabile (quindi fogli CSS). Moltissimi sono i link e le guide su internet.
- XML: con latex, quindi, si presenta il problema della portabilita'. In questo senso, XML si sta sempre piu' imponendo sulla scena mondiale. Puo' sembrare plausibile scegliere come il nostro formato standard per la scrittura della documentazione. Svantaggio: bisogna creare grammatiche e tutto quanto serve per "trasportare" il sorgente XML in altri formati. E questo e' un lavoro complicatissimo. Inoltre, bisogna pure considerare il fattore "apprendimento delle tecniche" per scrivere la documentazione. A cio' ho trovato una soluzione elegante, veloce, valida.
- DocBook: e' un linguaggio della famiglia di XML, potremmo considerarlo come una sorta di dialetto di XML. Ha dalla sua il fatto che molti progetti di un certo livello, ceh di conseguenza hanno richiesto una documentazione non banale dal punto di vista della quantita' di informazioni e qualita' dell'output, hanno scelto di sviluppare la medesima documentazione usando il sistema DocBook. Brevemente, un sorgente DocBook (che sostanzialmente e' XML) puo' essere portato con difficolta' pari a zero ai formati piu' disparati, e il codice risultanto e' pulito, facilmente scalabile. Ho preso visione dei sorgenti di "DocBook: The Definitive Guide e di "SVN Book" e guardando ai loro output, non rimane da dire che e' un ottimo sistema. Output supportato pienamente: HTML, XHTML, PDF, PS, RTF, PLAINTEXT. Comunque, all'interno del team, c'e' la necessita' per molti di imparare un nuovo strumento per la produzione di testo: DocBook, per tutte queste sue caratteristiche si fa preferire alle precedenti due alternative. Su DocBook sono stati raccolti pareri solo positivi.
Trac
Questo sito e' temporaneo. Mi serve per poter gestire al meglio tutte le prime attivita'. Ci serve chiaramente un gestore di progetti, e qui la discussione nemmeno nasce. Trac e' forse il miglior strumento per la gestione e lo sviluppo di progetti. E' una sorta di integrazione fra un wiki a un issue-tracking. Fornisce anche una interfaccia per usare SubVersion. In questo stesso mio spazio ho la possibilita' di attivare un trac ed usare circa 400 megabytes di spazio web. Sembrano bastare. Questo thread e' stato poco discusso: si attendono risposte.