Paolo Dalprato
Creare manuali online con MkDocs e GitHub Pages¶
Ultimo aggiornamento: 20 dicembre 2025
Questa guida documenta un approccio pratico per pubblicare documentazione tecnica sul web: manuali, guide, corsi online. Nasce da un'esigenza concreta, vale a dire mantenere aggiornati dei manuali su strumenti AI che evolvono rapidamente, e dalla collaborazione tra un professionista e Claude, l'assistente AI di Anthropic.
Non è un tutorial passo-passo. È il racconto di un flusso di lavoro, delle scelte architetturali che lo sostengono, e di come la collaborazione umano-AI può accelerare progetti di questo tipo.
A chi è rivolta¶
Professionisti che producono e distribuiscono contenuti informativi: formatori, insegnanti, documentalisti, giornalisti, divulgatori. Persone che hanno familiarità con la scrittura ma non necessariamente con lo sviluppo web, e che cercano un sistema sostenibile per pubblicare e aggiornare documentazione online.
Cosa troverai¶
- Il problema che ha motivato questo progetto e la soluzione adottata
- L'architettura tecnica: quali strumenti, perché questi e non altri
- Il workflow operativo: come si passa da un contenuto grezzo a un sito pubblicato
- Le istruzioni per replicare il sistema
- Riflessioni sulla collaborazione umano-AI nel processo
Il progetto¶
Questo stesso sito è il risultato del processo descritto. È ospitato su GitHub Pages, generato con MkDocs e Material for MkDocs, e sviluppato in collaborazione con Claude. Il repository è privato, ma il sito pubblicato è accessibile a tutti.
La documentazione che stai leggendo è stata creata usando esattamente il workflow che descrive.