Aggiungere https negli URL dei file yml.

Vedi anche italia/docs-italia-starter-kit#4

Correggere le sezioni relative ai tag condivisi alla luce delle nuove modifiche lato sviluppo.

Vedi italia/docs-italia-starter-kit#5

La Guida non spiega come convertire documenti con immagini in pandoc.

Indicare che il repo di configurazione deve chiamarsi italia-conf.

Aggiornare i nomi delle variabili. Vedi italia/docs-italia-starter-kit#9

Il pulsante "copia link" della sezione "vedi azioni" di ogni capitolo riporta all'URL del documento principale.
Inoltre ho notato che lo stesso link su sistemi desktop per essere copiato necessita di un click sinistro, l'utente medio che utilizza windows, potrebbe essere portato ad usare il tasto destro e la scelta di una voce "copia" per copiare il link. @pdavide @atorin

Modificare la numerazione delle appendici, per esempio usando lettere invece che numeri (come per Latex).

Migliorare la sezione sulla struttura del repo del documento.

Invece che usare la cartella _docs, si potrebbe usare una cartella col nome della sezione (vedi DAF).

Da una breve chiacchierata con @danielaiozzo è emerso che sarebbe opportuno pubblicare sulla guida una policy per la definizione dei nomi dei publisher (e quindi delle organizzazioni GitHub) perché questi impattano molto sulla leggibilità degli URL.
Questo, da un lato, eviterebbe casi estremi come "ufficioCircolariComuneDiAmbaradan" oppure "sono-un-fan-di-docs-italia", e dall'altro garantirebbe una più facile identificazione dei publisher a partire dagli URL (sia per gli utenti che per i motori di ricerca).
Sarebbe auspicabile avere degli schemi per:

• ministeri
• agenzie
• regioni
• città metropolitane
• comuni
• scuole

Questa policy, ovviamente, non avrebbe carattere prescrittivo e varrebbe solo per le amministrazioni che non hanno ancora un'organizzazione GitHub.

cc @francescozaia @atorin @sbronzolo

Dopo rapido confronto con @atorin, pensavamo di sostituire il punto 3 con il punto 2 nei passi da seguire per la richiesta di approvazione di una nuova organizzazione.
Questa modifica implica che, al momento della richiesta di approvazione, l'organizzazione GitHub dovrà già contenere il repo di configurazione, che è un'informazione importante anche ai fini dell'approvazione stessa.

Sostituire il link al convertitore con quello definitivo appena possibile.

Vedi #5

Se sei d'accordo proporrei una pull request riguardo alla parte di conversione in modo che punti ai comandi: https://github.com/italia/docs-italia-comandi-conversione#comandi-per-la-conversione

Nella sezione File requirements.txt, aggiungere il fatto che non deve essere specificata la versione del tema.

Vedi italia/docs-italia-theme#41