Documentare la didattica con la sintassi Markdown su GitHub

In questi giorni sto svolgendo attività di formazione per un percorso ITS (per neodiplomati) presso l’IIS Vallauri di Fossano (Cn) il mio intervento ha l’obiettivo di insegnare a prototipare un kit robotico ad uso didattico, mentre a Torino presso l’IIS Primo Levi sto seguendo dei ragazzi di 4’ superiore in un percorso di Alternanza Scuola Lavoro di Digital Fabrication (dalla stampa 3D alla prototipazione elettronica). Per tutti queste attività l’azione del documentare da parte degli studenti è essenziale,  pertanto ho aggiunto un modulo specifico sulle metodologie di progettazione e sul tecniche di documentazione che integrerò, con opportuni aggiustamenti, nelle mie attività didattiche dal prossimo anno scolastico.

Occupandomi di argomenti molto tecnici ho deciso di insegnare a produrre documentazione usando la sintassi Markdown e la condivisione dei propri progetti su GitHub, ciò permetterà di gestire in modo ottimale il versioning dei progetti (di qualsiasi genere non solo informatici) e non ultimo produrre pagine web di progetto realizzate con Jekyll.

Ho incominciato quindi a produrre qualche breve tutorial (tutto ancora in costruzione) sull’uso di GitHub, GitHub Pages e Markdown, che potete trovare a questo link, inoltre qualche tempo fa avevo già prodotto un tutorial su Markdown che potete leggere a questo link.

Nel caso riteniate utile il tutorial copiate e migliorate.

Un caro saluto.

Questa voce è stata pubblicata in tutorial e contrassegnata con , . Contrassegna il permalink.

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *

Questo sito usa Akismet per ridurre lo spam. Scopri come i tuoi dati vengono elaborati.