Torna alla Formazione

Linee Guida Autori

Standard e requisiti per la creazione di contenuti formativi su HackPA. Queste linee guida garantiscono qualita, coerenza e accessibilita di tutti i materiali pubblicati.

Struttura del contenuto

  • Ogni tutorial deve avere un titolo chiaro e descrittivo
  • Includere una sezione "Prerequisiti" con i requisiti minimi
  • Suddividere il contenuto in sezioni logiche con titoli H2/H3
  • Aggiungere un sommario (Table of Contents) per tutorial superiori a 10 minuti di lettura
  • Concludere con una sezione "Risorse aggiuntive" con link a documentazione ufficiale

Codice e esempi

  • Tutto il codice deve essere funzionante e testato
  • Utilizzare syntax highlighting con il linguaggio specificato
  • Includere commenti esplicativi nel codice
  • Fornire repository di esempio quando possibile (su Gitea privato)
  • Utilizzare versioni stabili e aggiornate delle librerie
  • Evitare dipendenze non necessarie

Accessibilita e standard

  • Il codice HTML deve essere semantico e accessibile (WCAG 2.1 AA)
  • Utilizzare attributi ARIA dove necessario
  • Testare con screen reader (NVDA, VoiceOver)
  • Seguire le linee guida AgID per i contenuti web della PA
  • Utilizzare Bootstrap Italia per gli esempi di interfaccia
  • Rispettare il profilo DCAT-AP_IT per i metadati dei dataset

Riferimenti normativi

  • Citare sempre la normativa di riferimento (D.Lgs., Circolari AgID, etc.)
  • Linkare alla Gazzetta Ufficiale o EUR-Lex per i testi normativi
  • Verificare che i riferimenti siano aggiornati alla data di pubblicazione
  • Distinguere tra obblighi di legge e best practices
  • Includere la data di ultimo aggiornamento del tutorial

Formati accettati

Tutorial scritto

Articolo tecnico con codice, screenshot e spiegazioni passo-passo. Formato Markdown.

Video tutorial

Video di massimo 30 minuti con voice-over, screen recording e codice visibile. Risoluzione minima 1080p.

Corso strutturato

Serie di lezioni (minimo 6) con progressione didattica. Include esercizi pratici e progetto finale.

Webinar / Workshop

Evento live di 1-3 ore con parte teorica e pratica. Slide in formato accessibile.

Pronto a contribuire?

Hai letto le linee guida e vuoi proporre un contenuto? Compila il form di proposta.

Proponi un Corso