rimuovere `document.rst`

[danse]

attualmente convert.hs produce un document.rst ed un index.rst. @atorin suggerisce di rimuovere document.rst per evitare confusione.

la conversione da singolo documento a multiple sezioni è soggetta ad errore, per questo penso sia una buona idea mantenere il documento singolo a disposizione degli utenti. potremmo cambiare la struttura delle cartelle in modo che sia più chiara.

document.rst è anche usato per rilevare e contare gli errori di sintassi, il che è più complesso da fare sui files sphinx. anche questo si può continuare a fare con una struttura diversa delle cartelle

[danse]

ho aggiunto una sezione nel readme chiarendo la duplicazione https://github.com/italia/pandoc-docs2rst#documento-convertito-e-files-strutturati

[danse]

in realtà mantenere i risultati intermedi aiuta molto la risoluzione di errori relativa ad uno specifico stadio di conversione. al momento abbiamo:

• conversione pandoc con filtri
• applicazione del linker a normattiva
• conversione in formato sphinx

quando le varie parti evolvono riscontriamo dei cambiamenti ed è importante che siano facilmente attribuibili. l'interfaccia utente va semplificata, potremmo farlo in un repo separato chiamato convert-docs-italia che contenga solo il comando, non i test di regressione

[danse]

in realtà mantenere i risultati intermedi aiuta molto la risoluzione di errori relativa ad uno specifico stadio di conversione. al momento abbiamo:

• conversione pandoc con filtri
• applicazione del linker a normattiva
• conversione in formato sphinx

quando le varie parti evolvono riscontriamo dei cambiamenti ed è importante che siano facilmente attribuibili. l'interfaccia utente va semplificata, potremmo farlo in un repo separato chiamato convert-docs-italia che contenga solo il comando, non i test di regressione