Dork” post=95343Il manuale della classe intenderei scriverlo direttamente con il dtx (quando sarà il momento) sennò credo che diventerà impossibile stargli dietro (a tal proposito sono curioso di come fare la suddivisione in capitoli della documentazione, come inserire sul bordo a margine i comandi con in parte la loro descrizione, come inserire esempi di “codice applicato”, … tutte cose che nei miei primi dtx non ho mai fatto e nelle guide che ho letto non ho trovato…qualcuno ha per caso un dtx da suggerirmi di guardare per vedere com’è fatto?)
È raro che le documentazioni di classi o pacchetti siano suddivise in capitoli, anche perché o sono veramente classi/pacchetti enormi che richiedono centinaia di pagine, oppure è perfettamente possibile limitarsi alla suddivisione in sezioni.
Per inserire i comandi sul bordo margine in genere si utilizza il comando [tt]\DescribeMacro[/tt].
Per il “codice applicato”, esistono una serie anche abbastanza numerosa di pacchetti. Puoi trovarne una lista qui. Se dovessi scegliere adesso, mi orienterei su tcolorbox.
Ti consiglio di provare a partire da esempi di dtx semplici e man mano andare a leggere quelli di pacchetti “grandi” come mdframed (dove “grandi” vuol sottilineare sia la complessità del pacchetto che quella della documentazione). Esiste anche un manuale per realizzare dtx (di cui ora mi sfugge il nome).
Dork” post=95343Riguardo in fine la grafica non me ne sono dimenticato, non ho riportato le mie (scarsissime) competenze perché ritenevo che in quanto curatore e non autore, non fosse interessante in questo contesto.
In quanto curatore, però, puoi “consigliare caldamente” gli autori a usare i metodi “appropriati”, dove possibile naturalmente.
Ciao
Claudio