[RiminiLUG-General] LTSP: gestione della documentazione

[Ivan Tarozzi <ivan@xxxxxxxxxxxx>]

Dal primo incontro di ieri sera emerge la necessità di scegliere lo
strumento informatico idoneo per gestire la documentazione del gruppo
di studio. Tale doc riguarda sia documenti interni (elenco punti da
affrontare, note interne) che documenti "finali" da pubblicare come
how-to o manualistica.

Siccome esistono diverse alternative, ma sembra al momento difficile
individuare quella più idonea (sufficentemente flessibile ma fruibile
anche da persone non prettamente tecniche) forse la cosa migliore
prima della scelta dello strumento sarebbe quello di raccogliere le
esigenze in una lista.

Io butto giù qualche punto, magari cercate di integrarlo con vostre idee:

Premessa:
- La MailingList rimane uno strumento utile alle comunicazioni e
scambio idee particolari, ma difficilmente può essere usato come
strumento di sintesi (questo stesso elenco punti potrebbe essere
arrichito via scambio su ML ma poi sarebbe più semplice che fosse
razionalizzato in una paginetta riassuntiva....)
- L'attuale WIKI potrebbe in parte sopperire ad alcune delle esigenze,
ma occorre capire quali funzionalità supporta e soprattutto chi
può/deve farsi carico di aggiornare le pagine

Caratteristiche del sistema di gestione documentazione:
------------------------------------------------------------------------
- la doc dovrebbe consentire un minimo di formattazione e
organizzazione (capitoli-sezioni-....)
- la doc deve essere liberamente consultabile e disponibile dal sito RiminiLUG
- la doc dovrebbe poter essere scaricabile per consultazione off-line
- la doc dovrebbe poter essere stampata (almeno i documenti finali
how-to o manualistica)
- tutti gli appartenenti al gruppo di studio dovrebbero poter
apportare modifiche alla documentazione
- sarebbe opportuno un controllo di revisione sui documenti per vedere
le modifiche apportate e da chi
- L'editing della doc deve avvenire con stumenti alla portata di tutti
- L'editing della doc dovrebbe poter avvenire anche off-line
- Sarebbe utile poter gestire una serie di compiti con assegnazione di
priorità, stato di completamento, persona di riferimento... (tipo
ticket di trac, per chi lo conosce)
- La doc dovrebbe poter essere indicizzata da un "motore di ricerca"
- tutti gli appartenenti al gruppo di studio dovrebbero poter caricare
in uno spazio condiviso frammenti di script o files di log



PS:
una nota doverosa: siccome il gruppo di studio è costituito da persone
con esperienza diversa, dovremmo forse inizialmente tararci un po'
anche sul linguaggio da utilizzare. Siccome la mia estrazione tecnica
potrebbe a volte portare ad utilizzare termini o esposizione dei
concetti troppo tecnici (magari dando per scontato cose che invece non
lo sono per tutti), sarei grato a chiunque voglia segnalare cose poco
chiare.
Idem per l'utilizzo a volte di terminologia inglese a scopo
semplificativo (non lo faccio apposta ma a volte, soprattutto in
informatica, un termine inglese descrive molto meglio e più brevemente
un concetto rispetto all'equivalente italiano)

PSPS:
come avrete potuto notare sono un po' prolisso.... abbiate pazienza,
mi sto curando :)