No, il “literate programming” lo escludo. La procedura è già attiva , funzionante su più di 1000 clienti. (magari per il futuro)
Forse la cosa può funzionare così:
– strutturo il template base del manuale, che prevede l’ utilizzo di doc di testo (creati dagli sviluppatori) per i contenuti (ovvero per commentare le funzioni)
– una persona (io 😯 ) fà la prima versione del manuale
– creo (o utilizzo) un GIT per gestire gli aggiornamenti della documentazione e creo un sistema a codice per nominare i file
– gli sviluppatori, ogni volta che ne hanno bisogno, modificano o creano nuovi doc di testo (nominati, se nuovi, con le regole date)
– con uno script o a mano si ricrea il manuale all’ occorrenza (che può essere pdf, html o altro)
l’ idea mi sembra bella. Implementarla è un’ altra cosa 😎
Ma non esisterà qlc cosa di già fatto?
Renato