Ciao a tutti,
volevo dire la mia sull’argomento (documentazione di LaTeX) da apprendista ovviamente.
Cosa ho studiato:
I testi i rete che ho studiato di più sono:
1 – le presentazioni delle quattro lezioni introduttive (Introduzione al mondo di LaTeX);
2 – la guida GuIT: Introduzione all’arte della composizione tipografia con LATEX;
3 – il manuale del pacchetto PGF.
Cosa ho rilevato (IMHO):
Questi tre documenti sono i principali miei riferimenti (ovviamente ho consultato molta altra documentazione, dello stesso Mori tra l’altro).
Le lezioni sono ottime per un riferimento iniziale, mentre la guida GuIT espone gli approfondimenti necessari per i primi documenti di produzione, mentre li manuale PGF offre una metodologia espositiva eccellente.
Tutti e tre messi insieme dicono: occorre un esposizione dell’argomento che ne delinei i concetti principali fondamentali, le specifiche di sintassi, applicazioni d’esempio in cui compare il codice assieme al risultato che produce e commenti utili.
Questo offre sia le informazioni necessarie per apprendere, sia il riferimento nell’uso e nella soddisfazione di particolari esigenze.
Cosa ritengo opportuno filosoficamente aldilà degli strumenti tecnici:
La documentazione di LaTeX dovrebbe :
1 – essere liberamente disponibile in rete ed aperta ai contributi;
2 – essere multilingua;
3 – essere scritta secondo uno stesso standard migliorabile e sufficientemente flessibile;
4 – essere aggiornata;
5 – essere strutturata così da rendere le informazioni facilmente rintracciabili;
6 – essere di qualità eccellente.
Spero che si possa fare un buon lavoro perchè ritengo che la documentazione sia il mezzo principale per consentire alle persone di scegliere LaTeX.
A presto.