Ciao Antonio, grazie per l'esempio che è molto utile per rendere l'idea! Antonio <antonio@piumarossa.it> writes:
Tutte le norme dovrebbero essere redatte in un formato "puro testo" (Markdown? Org-mode? Legal XML?) e archiviate in un DVCS (distributed version control system: git?) gestito Per Benino™: in questo modo per ciascuna norma sarebbe tracciabile ogni singola modifica (git blame...).
Ho provato con la Costituzione (so che su Github ce ne sono già diversi ma volevo qualcosa "in casa" per smanettare un po' su git). https://git.saela.eu/antonio/normativa/blob/master/costituzione_italiana.md e qui https://git.saela.eu/antonio/normativa/commits/master/costituzione_italiana.... i commit (ovvero tutte e 24 le modifiche costituzionali).
ma soprattutto la vista "git blame" che esplicita da dove viene (quale commit) ogni singola modifica: https://git.saela.eu/antonio/normativa/blame/master/costituzione_italiana.md Risulta chiaro che un ruolo molto importante nel tracciamento delle modifiche lo svolge il messaggio di commit, ad es.: https://git.saela.eu/antonio/normativa/commit/24b6bfb138e285a8103c68a9b14ada... --8<---------------cut here---------------start------------->8--- La LEGGE COSTITUZIONALE 9 febbraio 1963, n. 2 (in G.U. 12/02/1963, n.40) ha disposto (con l'art. 1) la modifica dell'art. 56. ha disposto (con l'art. 2) la modifica dell'art. 57. ha disposto (con l'art. 3) la modifica dell'art. 60. ha disposto (con l'art. 5) la modifica dell'art. 56. ha disposto (con l'art. 5) la modifica dell'art. 57. ha disposto (con l'art. 5) la modifica dell'art. 60. --8<---------------cut here---------------end--------------->8--- (AFAIK sarebbe meglio separare il titolo - ovvero la prima riga - dal corpo con una riga vuota) Ciascun messaggio di commit andrebbe redatto secondo delle chiare linee guida che stabiliscano i criteri col quale redigerlo, perché se redatti correttamente i messaggi di commit possono (e sono da molti progetti) utilizzati per ricavarne automaticamente un "changelog" (registro delle modifiche) che è molto utile per ripercorrere rapidamente (e superficialmente) la storia del documento senza dover consultare i log di git. L'interfaccia web non mi soddisfa molto per questa funzione (git blame) perché non c'è la possibilità di impostare l'"a capo" automatico e non si riescono a leggere tutte le frasi, ma di interfacce git ce ne sono molte; io per esempio uso Magit (in Emacs) e in allegato metto una schermata di blame (magit-blame) affiancata a una di log dei commit (magit-log), giusto per mostrare a chi non avesse già esperienza come si "naviga" un repo git con un'interfaccia diversa dal solito "forge" ala GitHub/GitLab Happy hacking! 380° -- 380° (lost in /traslation/) «Welcome to the chaos of the times If you go left and I go right Pray we make it out alive This is Karmageddon»
