[Docs] Infrastuttura per la gestione della documentazione

[Alan Franzoni]

Ho testato il py-rest-doc di Brandl. Il sistema non è malaccio ma è
ancora un bel po' grezzo e ampiamente in fieri, e la toolchain
necessita al momento di tutti i tool in versione sviluppo. Inoltre il
webserver apposito non sembra partire in maniera corretta,
lamentandosi della mancanza di un file che però la toolchain non ha
generato.

Così, "a pelle", mi sembra davvero più carino usare reST piuttosto che
LaTeX. Soprattutto sarebbe una buona idea, IMHO, usare lo stesso
markup per le pagine del CMS che dovrebbe gestire il sito, e la
documentazione. In questo modo si potrebbe dimezzare l'eventuale
necessario tempo di apprendimento.

Mi pare che per il sito l'indecisione fosse proprio tra reST e
Markdown... a meno che non troviamo anche un tool di conversione da/a
Markdown, potrebbe essere proprio questo l'ago della bilancia.

-- 
Alan Franzoni <alan.franzoni a gmail.com>
-
GPG Key Fingerprint:
5C77 9DC3 BD5B 3A28 E7BC 921A 0255 42AA FE06 8F3E